Compartilhar via


Control.Events Propriedade

Definição

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.

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 da propriedade

A lista de delegados de manipulador de eventos.

Exemplos

O exemplo a seguir cria um evento chamado Click, que adiciona e remove manipuladores da coleção do EventHandlerList controle quando o evento é chamado de uma página.

Observação

Este exemplo otimiza como um controle adiciona e remove eventos da lista deles que o controle mantém. Se você criar um controle personalizado e quiser definir um evento, use um código semelhante a este. Essa técnica pode ser usada em C#, mas não no 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);
    }
}

Comentários

Essa propriedade é do tipo EventHandlerList, que usa um algoritmo de pesquisa linear para localizar entradas na lista de delegados. Um algoritmo de pesquisa linear é ineficiente ao trabalhar com um grande número de entradas. Portanto, quando você tiver uma lista grande, a localização de entradas com essa propriedade será lenta.

Aplica-se a

Confira também