DataGridViewComboBoxCell.GetFormattedValue Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém o valor formatado dos dados da célula.

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

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

O valor a ser formatado.

rowIndex

Int32

O índice da linha pai da célula.

cellStyle

DataGridViewCellStyle

O DataGridViewCellStyle em vigor para a célula.

valueTypeConverter

TypeConverter

Um TypeConverter associado ao tipo de valor que fornece conversão personalizada para o tipo de valor formatado ou null se nenhuma conversão personalizada for necessária.

formattedValueTypeConverter

TypeConverter

Um TypeConverter associado ao tipo de valor formatado que fornece conversão personalizada para o tipo de valor ou null se nenhuma conversão personalizada for necessária.

context

DataGridViewDataErrorContexts

Uma combinação bit a bit dos valores DataGridViewDataErrorContexts que descreve o contexto no qual o valor formatado é necessário.

Retornos

Object

O valor dos dados da célula após a aplicação da formatação ou null se a célula não fizer parte de um controle DataGridView.

Exceções

Exception

Falha ao formatar e não há nenhum manipulador para o evento DataError do controle DataGridView ou o manipulador definiu a propriedade ThrowException como true. O objeto de exceção normalmente pode ser convertido no tipo FormatException para erros de conversão de tipo ou no tipo ArgumentException se value não foi encontrado no DataSource ou na coleção Items.

Comentários

O DataGridView controle chama esse método para converter um valor de célula em um valor de exibição equivalente do tipo indicado pela FormattedValueType propriedade . O controle passa o valor da célula para esse método no value parâmetro .

Esse método primeiro determina se value é válido determinando se uma das seguintes condições é atendida.

• value está presente na DataSource coleção ou Items .

• value é null ou DBNull.Value.

• value é String.Empty e o valor da ValueType propriedade representa o String tipo .

Se value não for válido, o DataGridView.DataError evento ocorrerá. Se não houver nenhum manipulador para esse evento ou o manipulador definir a DataGridViewDataErrorEventArgs.ThrowException propriedade truecomo , uma exceção será gerada.

Se value for válido ou se houver um manipulador para o DataError evento e ele não definir a DataGridViewDataErrorEventArgs.ThrowException propriedade como true, o DataGridView.CellFormatting evento ocorrerá.

Um CellFormatting manipulador de eventos pode modificar e cellStylevalue . No entanto, se o manipulador não definir a DataGridViewCellFormattingEventArgs.FormattingApplied propriedade truecomo , esse método value formatará usando as propriedades de formatação do cellStyle objeto . Isso pode resultar em um evento adicional DataError .

Se a formatação for bem-sucedida, esse método retornará o valor formatado para exibição no DataGridView controle .

Confira também

• FormattedValueType
• DataSource
• Items
• DataGridView
• DataGridViewCellStyle
• TypeConverter
• DataGridViewDataErrorContexts
• Format
• CellFormatting
• DataError
• GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
• ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)