DataGridViewCell.GetFormattedValue Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém o valor da célula como formatado para exibição.

protected:
 virtual 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 virtual 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 virtual 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);
abstract member GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Protected Overridable 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 formatado da célula ou null se a célula não pertencer a 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. Normalmente, o objeto de exceção pode ser convertido para o tipo FormatException.

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 gera o DataGridView.CellFormatting evento. Um manipulador para esse evento pode modificar os value parâmetros e cellStyle . Se o manipulador não definir a DataGridViewCellFormattingEventArgs.FormattingApplied propriedade como true, no entanto, esse método formata value usando as propriedades de formatação do cellStyle objeto.

Observação

Esse método não converte value no valor da DataGridViewCellStyle.NullValue propriedade para valores iguais ao valor da DataGridViewCellStyle.DataSourceNullValue propriedade quando DataSourceNullValue é definido como um valor diferente de DBNull.Value ou null. Nesse caso, você pode manipular o DataGridView.CellFormatting evento para exibir o valor da NullValue propriedade. Para obter mais informações, consulte o exemplo de código em DataSourceNullValue.

Se a formatação não for bem-sucedida, o DataError evento ocorrerá. Se não houver nenhum manipulador para esse evento ou o manipulador definir a DataGridViewDataErrorEventArgs.ThrowException propriedade como true, uma exceção será gerada.

Classes derivadas que substituem esse método normalmente retornarão uma representação de cadeia de caracteres do valor da célula se o context argumento incluir o ClipboardContent valor.

Aplica-se a

Confira também