Control.Events Control.Events Control.Events Control.Events Property

Définition

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle.Gets a list of event handler delegates for the control. Cette propriété est en lecture seule.This property is read-only.

protected:
 property System::ComponentModel::EventHandlerList ^ Events { System::ComponentModel::EventHandlerList ^ get(); };
protected System.ComponentModel.EventHandlerList Events { get; }
member this.Events : System.ComponentModel.EventHandlerList
Protected ReadOnly Property Events As EventHandlerList

Valeur de propriété

Liste des délégués de gestionnaires d'événements.The list of event handler delegates.

Exemples

L’exemple suivant crée un événement nommé Click, qui ajoute et supprime des gestionnaires de la collection du EventHandlerList contrôle lorsque l’événement est appelé à partir d’une page.The following example creates an event, named Click, that adds and removes handlers from the control's EventHandlerList collection when the event is called from a page.

Remarque Cet exemple optimise la manière dont un contrôle ajoute et supprime les événements de la liste que le contrôle gère.Note This example optimizes how a control adds and removes events from the list of them that the control maintains. Si vous créez un contrôle personnalisé et souhaitez définir un événement, utilisez un code similaire à celui-ci.If you create custom control and want to define an event, use code similar to this. Cette technique peut être utilisée dans C#, mais pas dans Visual Basic.This technique can be used in C#, but not in Visual Basic.

// Create an event that adds and removes handlers from the
// Control.Events collection when this event is called from
// a participating page.
public event EventHandler Click {
    add {
        Events.AddHandler(EventClick, value);
    }
    remove {
        Events.RemoveHandler(EventClick, value);
    }
}

Remarques

Cette propriété est de type EventHandlerList, qui utilise un algorithme de recherche linéaire pour rechercher des entrées dans la liste des délégués.This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. Un algorithme de recherche linéaire est inefficace lorsque vous travaillez avec un grand nombre d’entrées.A linear search algorithm is inefficient when working with a large number of entries. Par conséquent, lorsque vous avez une grande liste, la recherche d’entrées avec cette propriété est lente.Therefore, when you have a large list, finding entries with this property will be slow.

S’applique à

Voir aussi