DataGridViewRowErrorTextNeededEventHandler Délégué

  • Référence

Définition

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

Représente la méthode qui gérera l'événement RowErrorTextNeeded d'un DataGridView.

public delegate void DataGridViewRowErrorTextNeededEventHandler(System::Object ^ sender, DataGridViewRowErrorTextNeededEventArgs ^ e);
public delegate void DataGridViewRowErrorTextNeededEventHandler(object sender, DataGridViewRowErrorTextNeededEventArgs e);
public delegate void DataGridViewRowErrorTextNeededEventHandler(object? sender, DataGridViewRowErrorTextNeededEventArgs e);
type DataGridViewRowErrorTextNeededEventHandler = delegate of obj * DataGridViewRowErrorTextNeededEventArgs -> unit
Public Delegate Sub DataGridViewRowErrorTextNeededEventHandler(sender As Object, e As DataGridViewRowErrorTextNeededEventArgs)

Paramètres

sender
Object

Source de l'événement.

e
DataGridViewRowErrorTextNeededEventArgs

DataGridViewRowErrorTextNeededEventArgs qui contient les données d’événement.

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 DataGridViewRowErrorTextNeededEventArgs.RowIndex propriété pour déterminer l’état ou la valeur d’une ligne 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.

Lorsque vous créez un délégué DataGridViewRowErrorTextNeededEventHandler, vous identifiez la méthode qui gérera l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. Pour plus d’informations sur les délégués du gestionnaire d’événements, consultez Gestion et levée d’événements.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

S’applique à

Voir aussi