DataGridViewCell.ParseFormattedValue Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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);

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

Object

O valor da célula.

Exceções

ArgumentNullException

cellStyle é null.

FormatException

O valor da propriedade FormattedValueType é null.

- ou -

O valor da propriedade ValueType é null.

- ou -

formattedValue não pode ser convertido.

ArgumentException

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.

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)