DataGridViewDataErrorContexts Énumération

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

ClipboardContent 16384

Une erreur de données s'est produite lors de la copie du contenu vers le Presse-papiers. Cette valeur indique que la valeur de la cellule n'a pas pu être convertie en une chaîne.
Commit 512

Une erreur de données s'est produite lors de la validation des modifications dans le 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.
CurrentCellChange 4096

Une erreur de données s'est produite lors du déplacement du curseur de sélection vers une autre cellule. Cette valeur indique qu'un utilisateur a sélectionné une cellule alors qu'il y avait une condition d'erreur sur la cellule précédemment sélectionnée.
Display 2

Une erreur de données s'est produite lors de l'affichage d'une cellule qui a été 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 qu'un mappage qui traduit la valeur depuis la source de données vers la cellule est manquant.
Formatting 1

Une erreur de données s'est produite lors de la tentative de mise en forme des données qui sont envoyées à un magasin de données ou chargées à partir d'un magasin de données. Cette valeur indique qu'une modification de cellule n'a pas pu être correctement mise en forme. La nouvelle valeur de la cellule doit être corrigée ou la mise en forme de la cellule doit être modifiée.
InitialValueRestoration 1024

Une erreur de données s'est produite lors de la restauration de la valeur précédente d'une cellule. Cette valeur indique qu'une cellule a essayé d'annuler une modification et que la restauration de la valeur initiale a échoué. Cela peut se produire si la mise en forme de la cellule a été modifiée de telle façon qu'elle est incompatible avec la valeur initiale.
LeaveControl 2048

Une erreur de données s'est produite lorsque DataGridView a perdu le focus. Cette valeur indique que DataGridView n'a pas pu valider les modifications de l'utilisateur après avoir perdu le focus.
Parsing 256

Une erreur de données s'est produite lors de l'analyse de nouvelles données. Cette valeur indique que DataGridView n'a pas pu analyser les nouvelles données qui ont été entrées par l'utilisateur ou chargées à partir du magasin de données sous-jacent.
PreferredSize 4

Une erreur de données s'est produite lors du calcul de la taille par défaut d'une cellule. Cette valeur indique que DataGridView n'a pas pu calculer la largeur ou 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 lors de la suppression d'une ligne par DataGridView lié aux données.
Scroll 8192

Une erreur de données s'est produite lors du défilement d'une nouvelle région dans un affichage. Cette valeur indique qu'une cellule contenant des erreurs de données a défilé par programme dans un affichage ou à l'aide de la barre de défilement.

Exemples

L’exemple de code suivant illustre l’utilisation de ce type. Cet exemple fait partie d’un exemple plus vaste disponible dans Guide pratique pour gérer les erreurs qui se produisent pendant la saisie de données dans le contrôle DataGridView Windows Forms.

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, le DataGridView tente de valider la valeur de cellule non valide. Lorsque la validation échoue, le déclenche un DataError événement dont Context la DataGridView propriété aura les valeurs Commit et CurrentCellChange.

S’applique à

Voir aussi