Control.Events Właściwość

Definicja

Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu.

C#
protected System.ComponentModel.EventHandlerList Events { get; }

Wartość właściwości

Lista delegatów programu obsługi zdarzeń.

Przykłady

Poniższy przykład tworzy zdarzenie o nazwie Click, które dodaje i usuwa programy obsługi z kolekcji kontrolki EventHandlerList , gdy zdarzenie jest wywoływane ze strony.

Uwaga

W tym przykładzie optymalizuje sposób dodawania i usuwania z listy zdarzeń, które są obsługiwane przez kontrolkę. Jeśli tworzysz kontrolkę niestandardową i chcesz zdefiniować zdarzenie, użyj kodu podobnego do tego. Tej techniki można używać w języku C#, ale nie w Visual Basic.

C#
// 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);
    }
}

Uwagi

Ta właściwość jest typu EventHandlerList, która używa algorytmu wyszukiwania liniowego do znajdowania wpisów na liście delegatów. Algorytm wyszukiwania liniowego jest nieefektywny podczas pracy z dużą liczbą wpisów. W związku z tym, gdy masz dużą listę, znalezienie wpisów z tą właściwością będzie powolne.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też