Control.Events Właściwość

Definicja

Pobiera listę delegatów obsługi zdarzeń dla formantu.Gets a list of event handler delegates for the control. Ta właściwość jest tylko do odczytu.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

Wartość właściwości

Lista delegatów obsługi zdarzeń.The list of event handler delegates.

Przykłady

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

Uwaga

Ten przykład optymalizuje, jak kontrolka dodaje i usuwa zdarzenia z listy formantów, które przechowuje.This example optimizes how a control adds and removes events from the list of them that the control maintains. Jeśli tworzysz kontrolkę niestandardową i chcesz zdefiniować zdarzenie, użyj kodu podobnego do tego.If you create custom control and want to define an event, use code similar to this. Ta technika może być używana w C#, ale nie w 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);
    }
}

Uwagi

Ta właściwość jest typu EventHandlerList, który używa algorytmu wyszukiwania liniowego do znajdowania wpisów na liście delegatów.This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. Algorytm wyszukiwania liniowego jest nieefektywny podczas pracy z dużą liczbą wpisów.A linear search algorithm is inefficient when working with a large number of entries. W związku z tym, gdy masz dużą listę, znalezienie wpisów z tą właściwością będzie powolne.Therefore, when you have a large list, finding entries with this property will be slow.

Dotyczy

Zobacz też