Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
DataGridViewCell.GetFormattedValue (Método)
Obtiene el valor de la celda con el formato para mostrar.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
protected virtual Object GetFormattedValue( Object value, int rowIndex, ref DataGridViewCellStyle cellStyle, TypeConverter valueTypeConverter, TypeConverter formattedValueTypeConverter, DataGridViewDataErrorContexts context )
Parámetros
- value
- Tipo: System.Object
Valor al que se debe dar formato.
- rowIndex
- Tipo: System.Int32
Índice de la fila primaria de la celda.
- cellStyle
- Tipo: System.Windows.Forms.DataGridViewCellStyle%
DataGridViewCellStyle en vigor para la celda.
- valueTypeConverter
- Tipo: System.ComponentModel.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
- Tipo: System.ComponentModel.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
- Tipo: System.Windows.Forms.DataGridViewDataErrorContexts
Combinación bit a bit de valores de DataGridViewDataErrorContexts que describe el contexto en el que es necesario el valor con formato.
Valor devuelto
Tipo: System.ObjectValor con formato de la celda o null si la celda no pertenece a un control DataGridView.
| Excepción | Condición |
|---|---|
| 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 en un tipo de FormatException. |
El control DataGridView llama a este método para convertir un valor de celda en un valor de presentación equivalente del tipo que indica la propiedad FormattedValueType. El control pasa el valor de celda al método en el parámetro value.
Este método provoca el evento DataGridView.CellFormatting. Un controlador para este evento puede modificar los parámetros value y cellStyle. Sin embargo, si el controlador no establece la propiedad DataGridViewCellFormattingEventArgs.FormattingApplied en true, este método da formato a value utilizando las propiedades de formato del objeto cellStyle.
Nota
|
|---|
|
Este método no convierte value en el valor de la propiedad DataGridViewCellStyle.NullValue en el caso de valores iguales al valor de la propiedad DataGridViewCellStyle.DataSourceNullValue cuando DataSourceNullValue se establece en un valor que no es DBNull.Value ni null. En este caso, puede controlar el evento DataGridView.CellFormatting para mostrar el valor de propiedad NullValue. Para obtener más información, vea el ejemplo de código en DataSourceNullValue. |
Si la asignación de formato no se realiza correctamente, se produce el evento DataError. Si no hay un controlador para este evento o si el controlador establece la propiedad DataGridViewDataErrorEventArgs.ThrowException en true, se produce una excepción.
Las clases derivadas que reemplazan este método normalmente devolverán una representación de cadena del valor de celda si el argumento context incluye el valor de ClipboardContent.
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
