DataGridViewCell.GetFormattedValue Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene el valor de la celda con el formato para mostrar.

protected:
 virtual System::Object ^ GetFormattedValue(System::Object ^ value, int rowIndex, System::Windows::Forms::DataGridViewCellStyle ^ % cellStyle, System::ComponentModel::TypeConverter ^ valueTypeConverter, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::Windows::Forms::DataGridViewDataErrorContexts context);

protected virtual object GetFormattedValue (object value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter valueTypeConverter, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);

abstract member GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj

Protected Overridable Function GetFormattedValue (value As Object, rowIndex As Integer, ByRef cellStyle As DataGridViewCellStyle, valueTypeConverter As TypeConverter, formattedValueTypeConverter As TypeConverter, context As DataGridViewDataErrorContexts) As Object

Parámetros

value

Object

Valor al que se debe dar formato.

rowIndex

Int32

Índice de la fila primaria de la celda.

cellStyle

DataGridViewCellStyle

Clase DataGridViewCellStyle en vigor para la celda.

valueTypeConverter

TypeConverter

TypeConverter asociado al tipo de valor que proporciona la conversión personalizada al tipo de valor con formato; o bien, null si no es necesaria esa conversión personalizada.

formattedValueTypeConverter

TypeConverter

TypeConverter asociado al tipo de valor con formato que proporciona la conversión personalizada desde el tipo de valor; o bien, null si no es necesaria esa conversión personalizada.

context

DataGridViewDataErrorContexts

Una combinación bit a bit de valores DataGridViewDataErrorContexts que describen el contexto en el que es necesario el valor con formato.

Devoluciones

Object

Valor con formato de la celda o null si la celda no pertenece a un control DataGridView.

Excepciones

Exception

Se ha producido un error al dar formato y, o bien no hay ningún controlador para el evento DataError del control DataGridView, o el controlador ha establecido la propiedad ThrowException en true. El objeto de excepción normalmente se puede convertir al tipo FormatException.

Comentarios

El DataGridView control llama a este método para convertir un valor de celda en un valor de presentación equivalente del tipo indicado por la FormattedValueType propiedad . El control pasa el valor de celda a este método en el value parámetro .

Este método genera el DataGridView.CellFormatting evento . Un controlador para este evento puede modificar los value parámetros y cellStyle . Sin embargo, si el controlador no establece la DataGridViewCellFormattingEventArgs.FormattingApplied propiedad trueen , este método da formato value mediante las propiedades de formato del cellStyle objeto .

Nota

Este método no convierte en el DataGridViewCellStyle.NullValue valor de propiedad de los valores iguales al valor de DataGridViewCellStyle.DataSourceNullValue propiedad cuando DataSourceNullValue se establece en un valor distinto DBNull.Value de o null.value En este caso, puede controlar el DataGridView.CellFormatting evento para mostrar el valor de la NullValue propiedad. Para más información y ver un código de ejemplo, vea DataSourceNullValue.

Si el formato no es correcto, se produce el DataError evento . Si no hay ningún controlador para este evento o el controlador establece la DataGridViewDataErrorEventArgs.ThrowException propiedad trueen , se produce una excepción.

Las clases derivadas que invalidan este método normalmente devolverán una representación de cadena del valor de celda si el context argumento incluye el ClipboardContent valor.

Consulte también

• FormattedValueType
• DataGridView
• CellFormatting
• DataError
• FormattingApplied
• TypeConverter
• DataGridViewCellStyle
• Format
• DataGridViewDataErrorContexts
• ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)