Condividi tramite


Control.Events Proprietà

Definizione

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.EventHandlerList
Protected ReadOnly Property Events As EventHandlerList

Valore 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.

Si applica a

Vedi anche