DataGridViewDataErrorContexts Enumeração

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

DataGridViewDataErrorContexts.cs

Representa o estado de um controle de DataGridView associado a dados quando ocorreu um erro de dados.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

Herança

Object

ValueType

Enum

DataGridViewDataErrorContexts

Atributos

FlagsAttribute

Campos

Nome	Valor	Description
Formatting	1	Ocorreu um erro de dados ao tentar formatar dados que estão sendo enviados para um armazenamento de dados ou sendo carregados de um armazenamento de dados. Esse valor indica que uma alteração em uma célula não foi formatada corretamente. O novo valor da célula precisa ser corrigido ou a formatação da célula precisa ser alterada.
Display	2	Ocorreu um erro de dados ao exibir uma célula que foi preenchida por uma fonte de dados. Esse valor indica que o valor da fonte de dados não pode ser exibido pela célula ou um mapeamento que traduz o valor da fonte de dados para a célula está ausente.
PreferredSize	4	Ocorreu um erro de dados ao calcular o tamanho preferencial de uma célula. Esse valor indica que falha ao DataGridView calcular a largura ou altura preferencial de uma célula ao redimensionar programaticamente uma coluna ou linha. Isso pode ocorrer se a célula não tiver formatado seu valor.
RowDeletion	8	Ocorreu um erro de dados ao excluir uma linha. Esse valor indica que o repositório de dados subjacente gerou uma exceção quando um associado a DataGridView dados excluiu uma linha.
Parsing	256	Ocorreu um erro de dados ao analisar novos dados. Esse valor indica que não DataGridView foi possível analisar novos dados inseridos pelo usuário ou carregados do armazenamento de dados subjacente.
Commit	512	Ocorreu um erro de dados ao confirmar alterações no armazenamento de dados. Esse valor indica que os dados inseridos em uma célula não puderam ser confirmados no armazenamento de dados subjacente.
InitialValueRestoration	1024	Ocorreu um erro de dados ao restaurar uma célula para seu valor anterior. Esse valor indica que uma célula tentou cancelar uma edição e a reversão para o valor inicial falhou. Isso poderá ocorrer se a formatação da célula for alterada para que ela seja incompatível com o valor inicial.
LeaveControl	2048	Ocorreu um erro de dados quando o DataGridView foco perdido. Esse valor indica que o usuário não pôde confirmar alterações após perder o DataGridView foco.
CurrentCellChange	4096	Ocorreu um erro de dados quando o cursor de seleção foi movido para outra célula. Esse valor indica que um usuário selecionou uma célula quando a célula selecionada anteriormente tinha uma condição de erro.
Scroll	8192	Ocorreu um erro de dados ao rolar uma nova região para exibição. Esse valor indica que uma célula com erros de dados foi rolada para exibição programaticamente ou com a barra de rolagem.
ClipboardContent	16384	Ocorreu um erro de dados ao copiar conteúdo para a Área de Transferência. Esse valor indica que o valor da célula não pôde ser convertido em uma cadeia de caracteres.

Exemplos

O exemplo de código a seguir ilustra o uso desse tipo. Este exemplo faz parte de um exemplo maior disponível em How to: Handle Errors That Occur During Data Entry in the Windows Forms DataGridView Control.

private void dataGridView1_DataError(object sender,
    DataGridViewDataErrorEventArgs e)
{
    // If the data source raises an exception when a cell value is 
    // commited, display an error message.
    if (e.Exception != null &&
        e.Context == DataGridViewDataErrorContexts.Commit)
    {
        MessageBox.Show("CustomerID value must be unique.");
    }
}

Private Sub dataGridView1_DataError(ByVal sender As Object, _
    ByVal e As DataGridViewDataErrorEventArgs) _
    Handles dataGridView1.DataError

    ' If the data source raises an exception when a cell value is 
    ' commited, display an error message.
    If e.Exception IsNot Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

        MessageBox.Show("CustomerID value must be unique.")

    End If

End Sub

Comentários

Os membros dessa enumeração podem ser combinados usando a operação OR bit a bit para representar o estado de um associado a DataGridView dados quando ocorreu um erro de dados. Por exemplo, se um usuário inserir um valor de célula inválido (como inserir um nome em uma célula que espera uma data) e selecionar uma célula diferente, tentará DataGridView confirmar o valor da célula inválido. Quando a confirmação falhar, o DataGridView evento gerará um DataError evento cuja Context propriedade terá um valor de Commit e CurrentCellChange.

Confira também

• DataGridView
• DataError
• Context