DataGridViewDataErrorContexts Enumerazione

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewDataErrorContexts.cs

Rappresenta lo stato di un controllo DataGridView associato a dati quando si è verificato un errore di dati.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

Ereditarietà

Object

ValueType

Enum

DataGridViewDataErrorContexts

Attributi

FlagsAttribute

Campi

Nome	Valore	Descrizione
Formatting	1	Si è verificato un errore di dati durante il tentativo di formattare i dati inviati a un archivio dati o durante il caricamento da un archivio dati. Questo valore indica che una modifica a una cella non è riuscita a formattare correttamente. È necessario correggere il nuovo valore della cella o modificare la formattazione della cella.
Display	2	Si è verificato un errore di dati durante la visualizzazione di una cella popolata da un'origine dati. Questo valore indica che il valore dell'origine dati non può essere visualizzato dalla cella oppure un mapping che converte il valore dall'origine dati alla cella è mancante.
PreferredSize	4	Si è verificato un errore di dati durante il calcolo delle dimensioni preferite di una cella. Questo valore indica che non è stato possibile calcolare la larghezza o l'altezza DataGridView preferita di una cella quando si ridimensiona a livello di codice una colonna o una riga. Ciò può verificarsi se la cella non è riuscita a formattarne il valore.
RowDeletion	8	Si è verificato un errore di dati durante l'eliminazione di una riga. Questo valore indica che l'archivio dati sottostante ha generato un'eccezione quando una riga associata a DataGridView dati è stata eliminata.
Parsing	256	Si è verificato un errore di dati durante l'analisi di nuovi dati. Questo valore indica che non DataGridView è stato possibile analizzare nuovi dati immessi dall'utente o caricati dall'archivio dati sottostante.
Commit	512	Si è verificato un errore di dati durante il commit delle modifiche all'archivio dati. Questo valore indica che non è stato possibile eseguire il commit dei dati immessi in una cella nell'archivio dati sottostante.
InitialValueRestoration	1024	Si è verificato un errore di dati durante il ripristino di una cella sul relativo valore precedente. Questo valore indica che una cella ha tentato di annullare una modifica e il rollback al valore iniziale non è riuscito. Ciò può verificarsi se la formattazione della cella è stata modificata in modo che non sia compatibile con il valore iniziale.
LeaveControl	2048	Si è verificato un errore di dati quando si è perso lo DataGridView stato attivo. Questo valore indica che non è stato possibile eseguire il DataGridView commit delle modifiche dell'utente dopo aver perso lo stato attivo.
CurrentCellChange	4096	Si è verificato un errore di dati quando il cursore di selezione è stato spostato in un'altra cella. Questo valore indica che un utente ha selezionato una cella quando la cella selezionata in precedenza presentava una condizione di errore.
Scroll	8192	Si è verificato un errore di dati durante lo scorrimento di una nuova area nella visualizzazione. Questo valore indica che una cella con errori di dati è stata visualizzata a livello di codice o con la barra di scorrimento.
ClipboardContent	16384	Si è verificato un errore di dati durante la copia del contenuto negli Appunti. Questo valore indica che non è stato possibile convertire il valore della cella in una stringa.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Gestire gli errori che si verificano durante l'immissione di dati nel controllo DataGridView di Windows Form.

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

Commenti

I membri di questa enumerazione possono essere combinati usando l'operazione OR bit per bit per rappresentare lo stato di un data-bound DataGridView quando si è verificato un errore di dati. Ad esempio, se un utente immette un valore di cella non valido ,ad esempio immettendo un nome in una cella che prevede una data, e quindi seleziona una cella diversa, tenterà DataGridView di eseguire il commit del valore di cella non valido. Quando il commit ha esito negativo, DataGridView genererà un DataError evento la cui Context proprietà avrà un valore Commit e CurrentCellChange.

Vedi anche

• DataGridView
• DataError
• Context