Control.Events Proprietà

Definizione

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.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

Valore della proprietà

Elenco dei delegati del gestore eventi.The list of event handler delegates.

Esempi

Nell'esempio seguente viene creato un evento, denominato Click, che aggiunge e rimuove i gestori dalla raccolta di EventHandlerList del controllo quando l'evento viene chiamato da una pagina.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.

Nota In questo esempio viene ottimizzato il modo in cui un controllo aggiunge e rimuove gli eventi dall'elenco di tali elementi gestiti dal controllo.Note This example optimizes how a control adds and removes events from the list of them that the control maintains. Se si crea un controllo personalizzato e si vuole definire un evento, usare codice simile al seguente.If you create custom control and want to define an event, use code similar to this. Questa tecnica può essere usata in C#, ma non in 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);
    }
}

Commenti

Questa proprietà è di tipo EventHandlerList, che usa un algoritmo di ricerca lineare per trovare le voci nell'elenco di delegati.This property is of type EventHandlerList, which uses a linear search algorithm to find entries in the list of delegates. Un algoritmo di ricerca lineare è inefficiente quando si lavora con un numero elevato di voci.A linear search algorithm is inefficient when working with a large number of entries. Pertanto, quando si dispone di un elenco di grandi dimensioni, la ricerca di voci con questa proprietà sarà lenta.Therefore, when you have a large list, finding entries with this property will be slow.

Si applica a

Vedi anche