DataGridView.RowErrorTextNeeded Événement

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;

public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;

public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler? RowErrorTextNeeded;

member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 

Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler 

Type d'événement

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement RowErrorTextNeeded . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider dans le débogage. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer par ou d’ajouter le message à un message multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type DataGridView nommé DataGridView1. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement RowErrorTextNeeded .

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}

Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

Remarques

L’événement RowErrorTextNeeded se produit uniquement lorsque la DataSource propriété du DataGridView contrôle est définie ou que sa VirtualMode propriété est true. La gestion de l’événement RowErrorTextNeeded est utile lorsque vous souhaitez déterminer l’erreur d’une ligne en fonction de son état et des valeurs qu’elle contient.

Lorsque vous gérez l’événement RowErrorTextNeeded et spécifiez le texte d’erreur dans le gestionnaire, un glyphe d’erreur s’affiche dans l’en-tête de ligne, sauf si la ShowRowErrors propriété a la valeur false. Lorsque l’utilisateur déplace le pointeur de la souris sur le glyphe d’erreur, le texte d’erreur s’affiche dans une info-bulle.

L’événement RowErrorTextNeeded se produit également chaque fois que la valeur de la DataGridViewRow.ErrorText propriété est récupérée.

Vous pouvez utiliser la DataGridViewRowErrorTextNeededEventArgs.RowIndex propriété pour déterminer l’état d’une ligne ou les valeurs qu’elle contient, et utiliser ces informations pour modifier ou modifier la DataGridViewRowErrorTextNeededEventArgs.ErrorText propriété. Cette propriété est initialisée avec la valeur de la propriété de ligne ErrorText , que la valeur d’événement remplace.

Gérez l’événement RowErrorTextNeeded lors de l’utilisation de grandes quantités de données pour éviter les pénalités de performances associées à la définition de la valeur de ligne ErrorText pour plusieurs lignes. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

S’applique à

Voir aussi

• DataSource
• VirtualMode
• ShowRowErrors
• DataGridViewRowErrorTextNeededEventHandler
• DataGridViewRowErrorTextNeededEventArgs
• ErrorText
• ErrorText
• OnRowErrorTextNeeded(DataGridViewRowErrorTextNeededEventArgs)
• DataGridView, contrôle (Windows Forms)