DataGridViewDataErrorContexts Énumération

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewDataErrorContexts.cs

Représente l’état d’un contrôle DataGridView lié aux données lorsqu’une erreur de données s’est produite.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

Héritage

Object

ValueType

Enum

DataGridViewDataErrorContexts

Attributs

FlagsAttribute

Champs

Nom	Valeur	Description
Formatting	1	Une erreur de données s’est produite lors de la tentative de mise en forme des données envoyées à un magasin de données ou chargées à partir d’un magasin de données. Cette valeur indique qu’une modification apportée à une cellule n’a pas pu être mise en forme correctement. Soit la nouvelle valeur de cellule doit être corrigée, soit la mise en forme de la cellule doit être modifiée.
Display	2	Une erreur de données s’est produite lors de l’affichage d’une cellule remplie par une source de données. Cette valeur indique que la valeur de la source de données ne peut pas être affichée par la cellule, ou un mappage qui traduit la valeur de la source de données vers la cellule est manquant.
PreferredSize	4	Une erreur de données s’est produite lors du calcul de la taille préférée d’une cellule. Cette valeur indique que l’échec DataGridView du calcul de la largeur ou de la hauteur par défaut d’une cellule lors du redimensionnement par programme d’une colonne ou d’une ligne. Cela peut se produire si la cellule n’a pas pu mettre en forme sa valeur.
RowDeletion	8	Une erreur de données s’est produite lors de la suppression d’une ligne. Cette valeur indique que le magasin de données sous-jacent a levé une exception lorsqu’une ligne liée aux DataGridView données a supprimé une ligne.
Parsing	256	Une erreur de données s’est produite lors de l’analyse de nouvelles données. Cette valeur indique que les DataGridView données n’ont pas pu analyser les nouvelles données entrées par l’utilisateur ou chargées à partir du magasin de données sous-jacent.
Commit	512	Une erreur de données s’est produite lors de la validation des modifications apportées au magasin de données. Cette valeur indique que les données entrées dans une cellule n’ont pas pu être validées dans le magasin de données sous-jacent.
InitialValueRestoration	1024	Une erreur de données s’est produite lors de la restauration d’une cellule à sa valeur précédente. Cette valeur indique qu’une cellule a tenté d’annuler une modification et que la restauration vers la valeur initiale a échoué. Cela peut se produire si la mise en forme de cellule a changé afin qu’elle soit incompatible avec la valeur initiale.
LeaveControl	2048	Une erreur de données s’est produite lorsque le DataGridView focus est perdu. Cette valeur indique que l’utilisateur n’a pas pu valider les DataGridView modifications apportées après avoir perdu le focus.
CurrentCellChange	4096	Une erreur de données s’est produite lorsque le curseur de sélection a été déplacé vers une autre cellule. Cette valeur indique qu’un utilisateur a sélectionné une cellule lorsque la cellule précédemment sélectionnée a une condition d’erreur.
Scroll	8192	Une erreur de données s’est produite lors du défilement d’une nouvelle région en mode affichage. Cette valeur indique qu’une cellule contenant des erreurs de données a fait défiler l’affichage par programmation ou avec la barre de défilement.
ClipboardContent	16384	Une erreur de données s’est produite lors de la copie du contenu dans le Presse-papiers. Cette valeur indique que la valeur de cellule n’a pas pu être convertie en chaîne.

Exemples

L’exemple de code suivant illustre l’utilisation de ce type. Cet exemple fait partie d’un exemple plus large disponible dans 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

Remarques

Les membres de cette énumération peuvent être combinés à l’aide de l’opération OR au niveau du bit pour représenter l’état d’une liaison DataGridView de données lorsqu’une erreur de données s’est produite. Par exemple, si un utilisateur entre une valeur de cellule non valide (par exemple, en entrant un nom dans une cellule qui attend une date), puis sélectionne une autre cellule, celle-ci DataGridView tente de valider la valeur de cellule non valide. Lorsque la validation échoue, l’événement DataGridView déclenche un DataError événement dont Context la propriété aura la valeur Commit et CurrentCellChange.

Voir aussi

• DataGridView
• DataError
• Context