DataGridViewDataErrorContexts Enumeração

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa o estado de um controle 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

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 pode ser convertido em uma cadeia de caracteres.
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 para o armazenamento de dados subjacente.
CurrentCellChange	4096	Ocorreu um erro de dados quando o cursor de seleção foi movido para outra célula. Esse valor indica que o usuário selecionou uma célula quando a célula selecionada anteriormente tinha uma condição de erro.
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 converte o valor da fonte de dados para a célula está ausente.
Formatting	1	Ocorreu um erro de dados durante a tentativa de formatar os 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 de célula precisa ser corrigido ou a formatação da célula precisa ser alterada.
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 a edição e a reversão para o valor inicial falhou. Isso pode ocorrer se a formatação da célula foi alterada de forma que ela não é compatível com o valor inicial.
LeaveControl	2048	Um erro de dados ocorreu quando o DataGridView perdeu o foco. Esse valor indica que DataGridView não conseguiu confirmar as alterações do usuário depois de perder o foco.
Parsing	256	Ocorreu um erro de dados ao analisar novos dados. Esse valor indica que o DataGridView não conseguiu analisar novos dados que foram digitados pelo usuário ou carregados do armazenamento de dados subjacente.
PreferredSize	4	Ocorreu um erro de dados ao calcular o tamanho preferencial de uma célula. Esse valor indica que o DataGridView falhou ao calcular a largura preferencial ou a altura de uma célula ao redimensionar programaticamente uma coluna ou linha. Isso pode ocorrer se a célula falhou ao formatar seu valor.
RowDeletion	8	Ocorreu um erro de dados ao excluir uma linha. Esse valor indica que o armazenamento de dados subjacente emitiu uma exceção quando um DataGridView associado a dados excluiu uma linha.
Scroll	8192	Ocorreu um erro de dados ao rolar uma nova região em modo de exibição. Esse valor indica que uma célula com erros de dados foi rolada até o modo de exibição de modo programático ou com a barra de rolagem.

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, em seguida, selecionar uma célula diferente, o DataGridView tentará confirmar o valor inválido da célula. Quando o commit falhar, o DataGridView gerará um DataError evento cuja Context propriedade terá um valor de Commit e CurrentCellChange.

Confira também

• DataGridView
• DataError
• Context