DataGridViewRowErrorTextNeededEventArgs Classe

Définition

Fournit des données destinées à l'événement RowErrorTextNeeded d'un contrôle DataGridView.

public ref class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
type DataGridViewRowErrorTextNeededEventArgs = class
    inherit EventArgs
Public Class DataGridViewRowErrorTextNeededEventArgs
Inherits EventArgs
Héritage
DataGridViewRowErrorTextNeededEventArgs

Exemples

L’exemple de code suivant illustre l’utilisation de ce type. 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 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 propriété de DataGridView contrôle DataSource 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 DataGridView.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 RowIndex propriété pour déterminer l’état ou la valeur d’une ligne et utiliser ces informations pour modifier ou modifier la 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.

Propriétés

ErrorText

Obtient ou définit le texte d'erreur pour la ligne.

RowIndex

Obtient la ligne qui a déclenché l'événement RowErrorTextNeeded.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à

Voir aussi