DataGridViewDataErrorContexts Enumerazione

Definizione

Rappresenta lo stato di un controllo DataGridView con associazione a dati quando si verifica un errore nei dati.Represents the state of a data-bound DataGridView control when a data error occurred.

Questa enumerazione ha un attributo FlagsAttribute che consente una combinazione bit per bit dei valori del relativo membro.

public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
type DataGridViewDataErrorContexts = 
Public Enum DataGridViewDataErrorContexts
Ereditarietà
DataGridViewDataErrorContexts
Attributi

Campi

ClipboardContent 16384

Si è verificato un errore nei dati durante la copia del contenuto negli Appunti.A data error occurred when copying content to the Clipboard. Questo valore indica che non è stato possibile convertire in formato stringa il valore di una cella.This value indicates that the cell value could not be converted to a string.

Commit 512

Si è verificato un errore nei dati durante il commit delle modifiche nell'archivio dati.A data error occurred when committing changes to the data store. Questo valore indica che non è stato possibile eseguire il commit dei dati inseriti in una cella nell'archivio dati sottostante.This value indicates that data entered in a cell could not be committed to the underlying data store.

CurrentCellChange 4096

Si è verificato un errore nei dati durante lo spostamento del cursore di selezione in un'altra cella.A data error occurred when the selection cursor moved to another cell. Questo valore indica che un utente ha selezionato una cella mentre era presente una condizione di errore nella cella precedentemente selezionata.This value indicates that a user selected a cell when the previously selected cell had an error condition.

Display 2

Si è verificato un errore nei dati durante la visualizzazione di una cella nella quale erano stati inseriti dati recuperati da un'origine dati.A data error occurred when displaying a cell that was populated by a data source. Questo valore indica che il valore dell'origine dati non può visualizzato nella cella oppure che non è stato eseguito il mapping per la conversione del valore dall'origine dati alla cella.This value indicates that the value from the data source cannot be displayed by the cell, or a mapping that translates the value from the data source to the cell is missing.

Formatting 1

Si è verificato un errore nei dati durante la formattazione dei dati inviati a un archivio o caricati da un archivio.A data error occurred when trying to format data that is either being sent to a data store, or being loaded from a data store. Questo valore indica che non è stato possibile formattare correttamente una modifica apportata a una cella.This value indicates that a change to a cell failed to format correctly. È necessario correggere il nuovo valore o modificare la formattazione della cella.Either the new cell value needs to be corrected or the cell's formatting needs to change.

InitialValueRestoration 1024

Si è verificato un errore nei dati durante la reimpostazione del valore precedente di una cella.A data error occurred when restoring a cell to its previous value. Questo valore indica che una cella ha tentato di annullare una modifica e che il ripristino del valore iniziale non è riuscito.This value indicates that a cell tried to cancel an edit and the rollback to the initial value failed. Questo errore può verificarsi se la formattazione della cella è cambiata e non risulta più compatibile con il valore iniziale.This can occur if the cell formatting changed so that it is incompatible with the initial value.

LeaveControl 2048

Si è verificato un errore nei dati durante la perdita dello stato attivo da parte dell'oggetto DataGridView.A data error occurred when the DataGridView lost focus. Questo valore indica che l'oggetto DataGridView non ha potuto eseguire il commit delle modifiche apportate dall'utente dopo la perdita dello stato attivo.This value indicates that the DataGridView could not commit user changes after losing focus.

Parsing 256

Si è verificato un errore nei dati durante l'analisi dei nuovi dati.A data error occurred when parsing new data. Questo valore indica che l'oggetto DataGridView non ha potuto eseguire l'analisi dei nuovi dati immessi dall'utente o caricati dall'archivio dati sottostante.This value indicates that the DataGridView could not parse new data that was entered by the user or loaded from the underlying data store.

PreferredSize 4

Si è verificato un errore nei dati durante il calcolo della dimensione preferenziale di una cella.A data error occurred when calculating the preferred size of a cell. Questo valore indica che l'oggetto DataGridView non è riuscito a calcolare la larghezza o l'altezza preferenziale di una cella durante il ridimensionamento di una colonna o una riga a livello di codice.This value indicates that the DataGridView failed to calculate the preferred width or height of a cell when programmatically resizing a column or row. Questo errore può verificarsi se non è stato possibile formattare il valore della cella.This can occur if the cell failed to format its value.

RowDeletion 8

Si è verificato un errore nei dati durante l'eliminazione di una riga.A data error occurred when deleting a row. Questo valore indica che l'archivio dati sottostante ha generato un'eccezione quando è stata eliminata una riga nell'oggetto DataGridView con associazione a dati.This value indicates that the underlying data store threw an exception when a data-bound DataGridView deleted a row.

Scroll 8192

Si è verificato un errore nei dati durante lo scorrimento di una nuova area.A data error occurred when scrolling a new region into view. Questo valore indica che è stato eseguito lo scorrimento, a livello di codice o tramite la barra di scorrimento, di una cella contenente errori nei dati.This value indicates that a cell with data errors scrolled into view programmatically or with the scroll bar.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo tipo.The following code example illustrates the use of this type. Questo esempio fa parte di un esempio più ampio disponibile in procedura: Gestire gli errori che si verificano durante l'immissione di datinel controllo DataGridView Windows Forms.This example is part of a larger example available in 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

Commenti

I membri di questa enumerazione possono essere combinati utilizzando l'operazione OR bit per bit per rappresentare lo stato di DataGridView un oggetto associato a dati quando si verifica un errore di dati.Members of this enumeration may be combined using the bitwise OR operation to represent the state of a data-bound DataGridView when a data error occurred. Se, ad esempio, 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 DataGridView cella diversa, tenterà di eseguire il commit del valore di cella non valido.For example, if a user enters an invalid cell value (such as entering a name in a cell that expects a date) and then selects a different cell, the DataGridView will try to commit the invalid cell value. Quando il commit ha esito DataGridView negativo, genera DataError un evento Context la cui proprietà avrà il valore commit e CurrentCellChange.When the commit fails, the DataGridView will raise a DataError event whose Context property will have a value of Commit and CurrentCellChange.

Si applica a

Vedi anche