Control.Events Vlastnost

Definice

Načte seznam delegátů obslužných rutin událostí pro ovládací prvek.Gets a list of event handler delegates for the control. Tato vlastnost je jen ke čtení.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

Hodnota vlastnosti

EventHandlerList

Seznam delegátů obslužných rutin událostíThe list of event handler delegates.

Příklady

Následující příklad vytvoří událost s názvem Click , která přidá a odebere obslužné rutiny z kolekce ovládacího prvku, EventHandlerList když je událost volána ze stránky.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.

Poznámka

Tento příklad optimalizuje způsob, jakým ovládací prvek přidá nebo odebere události ze seznamu, který ovládací prvek udržuje.This example optimizes how a control adds and removes events from the list of them that the control maintains. Pokud vytvoříte vlastní ovládací prvek a chcete definovat událost, použijte podobný kód.If you create custom control and want to define an event, use code similar to this. Tato technika se dá použít v jazyce C#, ale ne v 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);
    }
}

Poznámky

Tato vlastnost je typu EventHandlerList , který používá algoritmus lineárního vyhledávání k nalezení položek v seznamu delegátů.This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. Lineární algoritmus hledání je neefektivní při práci s velkým počtem položek.A linear search algorithm is inefficient when working with a large number of entries. Proto když máte rozsáhlý seznam, hledání položek s touto vlastností bude pomalé.Therefore, when you have a large list, finding entries with this property will be slow.

Platí pro

Viz také