Control.Events Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura.
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
Valor de propiedad
Lista de delegados de controladores de eventos.
Ejemplos
En el ejemplo siguiente se crea un evento, denominado Click
, que agrega y quita controladores de la colección del EventHandlerList control cuando se llama al evento desde una página.
Nota:
En este ejemplo se optimiza la forma en que un control agrega y quita eventos de la lista de ellos que mantiene el control. Si crea un control personalizado y desea definir un evento, use código similar a este. Esta técnica se puede usar en C#, pero no en 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);
}
}
Comentarios
Esta propiedad es de tipo EventHandlerList, que usa un algoritmo de búsqueda lineal para buscar entradas en la lista de delegados. Un algoritmo de búsqueda lineal es ineficaz al trabajar con un gran número de entradas. Por lo tanto, cuando tenga una lista grande, la búsqueda de entradas con esta propiedad será lenta.