DataGridViewCell.GetFormattedValue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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);
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
Valor con formato de la celda o null
si la celda no pertenece a un control DataGridView.
Excepciones
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 true
en , 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 true
en , 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.