DataGridViewComboBoxCell.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 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
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.
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 para escribir FormatException para errores de conversión de tipos o escribir ArgumentException si no se encuentra value
en la colección DataSource o la colección Items.
Comentarios
El DataGridView control llama a este método para convertir un valor de celda en un valor para mostrar 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 determina primero si value
es válido al determinar si se cumple una de las condiciones siguientes.
value
está presente en o DataSource en la Items colección .value
esnull
o DBNull.Value.value
es String.Empty y el valor de propiedad ValueType representa el String tipo.
Si value
no es válido, se produce el DataGridView.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.
Si value
es válido o hay un controlador para el DataError evento y no establece la DataGridViewDataErrorEventArgs.ThrowException propiedad true
en , se produce el DataGridView.CellFormatting evento.
Un CellFormatting controlador de eventos puede modificar y value
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 . Esto puede dar lugar a un evento adicional DataError .
Si el formato se realiza correctamente, este método devuelve el valor con formato para mostrarlo en el DataGridView control .
Se aplica a
Consulte también
- FormattedValueType
- DataSource
- Items
- DataGridView
- DataGridViewCellStyle
- TypeConverter
- DataGridViewDataErrorContexts
- Format
- CellFormatting
- DataError
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta:Enviar y ver comentarios de