Control.Events Propriedade

Definição

Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente 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 de Propriedade

A lista de delegados gestores de eventos.

Exemplos

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

Note

Este exemplo otimiza como um controlo adiciona e remove eventos da lista que o controlo mantém. Se crias controlo personalizado e quiseres definir um evento, usa código semelhante a este. Esta 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);
    }
}

Observações

Esta propriedade é do tipo EventHandlerList, que utiliza um algoritmo de pesquisa linear para encontrar entradas na lista de delegados. Um algoritmo de pesquisa linear é ineficiente quando trabalha com um grande número de entradas. Portanto, quando tem uma lista grande, encontrar entradas com esta propriedade será lento.

Aplica-se a

Ver também