DataGridViewCell.ParseFormattedValue Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte um valor formatado para exibição no valor real da célula.
public:
virtual System::Object ^ ParseFormattedValue(System::Object ^ formattedValue, System::Windows::Forms::DataGridViewCellStyle ^ cellStyle, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::ComponentModel::TypeConverter ^ valueTypeConverter);
public virtual object ParseFormattedValue (object formattedValue, System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.ComponentModel.TypeConverter valueTypeConverter);
public virtual object? ParseFormattedValue (object? formattedValue, System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter? formattedValueTypeConverter, System.ComponentModel.TypeConverter? valueTypeConverter);
abstract member ParseFormattedValue : obj * System.Windows.Forms.DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter -> obj
override this.ParseFormattedValue : obj * System.Windows.Forms.DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter -> obj
Public Overridable Function ParseFormattedValue (formattedValue As Object, cellStyle As DataGridViewCellStyle, formattedValueTypeConverter As TypeConverter, valueTypeConverter As TypeConverter) As Object
Parâmetros
- formattedValue
- Object
O valor de exibição da célula.
- cellStyle
- DataGridViewCellStyle
O DataGridViewCellStyle em vigor para a célula.
- formattedValueTypeConverter
- TypeConverter
Um TypeConverter para o tipo de valor de exibição ou null
para usar o conversor padrão.
- valueTypeConverter
- TypeConverter
Um TypeConverter para o tipo de valor da célula ou null
para usar o conversor padrão.
Retornos
O valor da célula.
Exceções
cellStyle
é null
.
O valor da propriedade FormattedValueType é null
.
- ou -
O valor da propriedade ValueType é null
.
- ou -
formattedValue
não pode ser convertido.
formattedValue
é null
.
- ou -
O tipo de formattedValue
não coincide com aquele indicado pela propriedade FormattedValueType.
Comentários
Quando o usuário edita um valor de célula e confirma a alteração, o DataGridView controle chama esse método para converter o valor exibido do FormattedValueType para o ValueType. Em seguida, o controle define o valor da célula subjacente ou o valor da fonte de dados como o valor convertido.
A implementação padrão desse método analisa o formattedValue
parâmetro usando as NullValuepropriedades , DataSourceNullValuee FormatProvider do estilo de célula indicado pelo cellStyle
parâmetro .
Se formattedValue
for igual a NullValue, esse método retornará o valor da DataSourceNullValue propriedade ou null
se DataSourceNullValue for DBNull.Value e a célula ValueType for um tipo de referência.
Se formattedValue
não for igual a NullValue, esse método analisará formattedValue
usando a FormatProvider propriedade e os conversores especificados ou padrão.
Se a célula ValueType for anulável, esse método encapsulará o valor retornado como um Nullable<T> tipo.
Aplica-se a
Confira também
- DataGridView
- DataGridViewCellStyle
- NullValue
- DataSourceNullValue
- FormatProvider
- ValueType
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- Nullable<T>
- Tipos anuláveis (Guia de Programação em C#)
- Tipos de valor que permitem valor nulo (Visual Basic)