Exporter (0) Imprimer
Développer tout
Développer Réduire
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

DataGridView.RowErrorTextNeeded, événement

Se produit lorsque le texte d'erreur d'une ligne est nécessaire.

Espace de noms: System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public event DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded
/** @event */
public void add_RowErrorTextNeeded (DataGridViewRowErrorTextNeededEventHandler value)

/** @event */
public void remove_RowErrorTextNeeded (DataGridViewRowErrorTextNeededEventHandler value)

En JScript, vous pouvez gérer les événements définis par une classe, mais vous ne pouvez pas définir les vôtres.
Non applicable.

L'événement RowErrorTextNeeded se produit uniquement lorsque la propriété DataSource du contrôle DataGridView est définie ou lorsque sa propriété VirtualMode est true. La gestion de l'événement RowErrorTextNeeded est utile lorsque vous souhaitez déterminer l'erreur pour 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 apparaît dans l'en-tête de ligne à moins que la propriété ShowRowErrors n'ait la valeur false. Lorsque l'utilisateur déplace le pointeur de la souris sur le glyphe d'erreur, le texte d'erreur apparaît dans une Info-bulle.

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

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

Gérez l'événement RowErrorTextNeeded lorsque vous utilisez de grandes quantités de données pour éviter une altération des performances due à la définition de la valeur de ErrorText de la ligne pour plusieurs lignes. Pour plus d'informations, consultez Méthodes conseillées pour la mise à l'échelle du contrôle DataGridView Windows Forms.

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

L'exemple de code suivant illustre l'utilisation de ce membre. Dans l'exemple, un gestionnaire d'événements génère des rapports sur l'occurrence de l'événement RowErrorTextNeeded. Ce rapport vous permet de savoir quand l'événement se produit et peut vous aider pendant le débogage. Pour générer un rapport sur plusieurs événements ou sur des événements qui se produisent fréquemment, pensez à remplacer System.Windows.Forms.MessageBox.Show par System.Console.WriteLine ou à ajouter le message à un TextBox multiligne.

Pour exécuter l'exemple de code, collez-le dans un projet qui contient une instance de type DataGridView nommée DataGridView1. Assurez-vous 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" );
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft. Tous droits réservés.