DataGridViewCell.GetEditedFormattedValue Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retorna o valor atual formatado da célula, independentemente de se a célula está em modo de edição e o valor não foi confirmado.

public:
 System::Object ^ GetEditedFormattedValue(int rowIndex, System::Windows::Forms::DataGridViewDataErrorContexts context);

public object GetEditedFormattedValue (int rowIndex, System.Windows.Forms.DataGridViewDataErrorContexts context);

member this.GetEditedFormattedValue : int * System.Windows.Forms.DataGridViewDataErrorContexts -> obj

Public Function GetEditedFormattedValue (rowIndex As Integer, context As DataGridViewDataErrorContexts) As Object

Parâmetros

rowIndex

Int32

O índice de linha da célula.

context

DataGridViewDataErrorContexts

Uma combinação bit a bit de valores DataGridViewDataErrorContexts que especifica o contexto do erro de dados.

Retornos

Object

O valor atual, formatado do DataGridViewCell.

Exceções

ArgumentOutOfRangeException

O rowIndex especificado é menor que 0 ou maior que o número de linhas no controle menos 1.

InvalidOperationException

ColumnIndex é menor que 0, indicando que a célula é uma célula de cabeçalho de linha.

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

Esse método retornará o valor atual da célula de edição ou do controle de edição se a célula estiver no modo de edição. Caso contrário, esse método converterá o valor da célula em um valor de exibição equivalente do tipo indicado pela FormattedValueType propriedade . Isso gera o DataGridView.CellFormatting evento , que você pode manipular para personalizar a conversão de valor.

Se a formatação não for bem-sucedida, o DataGridView.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.

Confira também

• DataGridView
• CellFormatting