DataGridViewCheckBoxCell.GetFormattedValue Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Obtiene el valor con formato de los datos de la celda.

protected:
 override 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 override 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);
protected override 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);
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Protected Overrides 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

El valor de los datos de la celda después de haber aplicado el formato o null si la celda no forma parte de un control DataGridView.

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 .

En primer lugar, este método intenta convertir value en un Boolean valor o CheckState mediante las TrueValuepropiedades , FalseValuey IndeterminateValue si se han establecido.

Si la conversión no se realiza correctamente, se produce el DataGridView.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.

Si la conversión es correcta o hay un controlador para el DataError evento y no establece la DataGridViewDataErrorEventArgs.ThrowException propiedad trueen , se produce el DataGridView.CellFormatting evento.

Un CellFormatting controlador de eventos puede modificar y valuecellStyle. 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 . Esto puede dar lugar a un evento adicional DataError .

Si el formato es correcto y el context valor del parámetro incluye el ClipboardContent valor , este método devuelve la String versión del valor con formato para copiar en el Portapapeles. De lo contrario, este método devuelve el valor con formato para mostrar en el DataGridView control .

Se aplica a

Consulte también