Control.Events Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura.
protected:
property System::ComponentModel::EventHandlerList ^ Events { System::ComponentModel::EventHandlerList ^ get(); };protected System.ComponentModel.EventHandlerList Events { get; }member this.Events : System.ComponentModel.EventHandlerListProtected ReadOnly Property Events As EventHandlerListValore della proprietà
Elenco dei delegati del gestore eventi.
Esempio
Nell'esempio seguente viene creato un evento denominato Click, che aggiunge e rimuove i gestori dalla raccolta del EventHandlerList controllo quando l'evento viene chiamato da una pagina.
Nota
In questo esempio viene ottimizzato il modo in cui un controllo aggiunge e rimuove gli eventi dall'elenco di essi che il controllo gestisce. Se si crea un controllo personalizzato e si vuole definire un evento, usare codice simile al seguente. Questa tecnica può essere usata in C#, ma non 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);
}
}
Commenti
Questa proprietà è di tipo EventHandlerList, che usa un algoritmo di ricerca lineare per trovare voci nell'elenco dei delegati. Un algoritmo di ricerca lineare è inefficiente quando si lavora con un numero elevato di voci. Pertanto, quando si dispone di un elenco di grandi dimensioni, la ricerca di voci con questa proprietà sarà lenta.
