EventHandler Delegar

Definição

Namespace:
System
Assemblies:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Representa o método que manipulará um evento que não tem dados de evento.

public delegate void EventHandler(System::Object ^ sender, EventArgs ^ e);
public delegate void EventHandler(object sender, EventArgs e);
[System.Serializable]
public delegate void EventHandler(object sender, EventArgs e);
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public delegate void EventHandler(object sender, EventArgs e);
type EventHandler = delegate of obj * EventArgs -> unit
[<System.Serializable>]
type EventHandler = delegate of obj * EventArgs -> unit
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type EventHandler = delegate of obj * EventArgs -> unit
Public Delegate Sub EventHandler(sender As Object, e As EventArgs)

Parâmetros

sender
Object

A fonte do evento.

e
EventArgs

Um objeto que não contém dados de evento.

Atributos
SerializableAttribute ComVisibleAttribute

Comentários

O modelo de evento no .NET baseia-se em ter um representante de evento que conecta um evento com seu manipulador. Para gerar um evento, dois elementos são necessários:

  • Um delegado que identifica o método que fornece a resposta ao evento.
  • Opcionalmente, uma classe que contém os dados do evento, se o evento fornecer dados.

O delegado é um tipo que define uma assinatura, ou seja, o tipo de valor retornado e tipos de lista de parâmetros para um método. Você pode usar o tipo delegado para declarar uma variável que pode se referir a qualquer método com a mesma assinatura que o delegado.

A assinatura padrão de um delegado do manipulador de eventos define um método que não retorna um valor. O primeiro parâmetro desse método é do tipo Object e refere-se à instância que gera o evento. Seu segundo parâmetro é derivado do tipo EventArgs e contém os dados do evento. Se o evento não gerar dados de evento, o segundo parâmetro será simplesmente o valor do EventArgs.Empty campo. Caso contrário, o segundo parâmetro é um tipo derivado EventArgs e fornece todos os campos ou propriedades necessários para manter os dados do evento.

O EventHandler delegado é um delegado predefinido que representa especificamente um método de manipulador de eventos para um evento que não gera dados. Se o evento gerar dados, você deverá usar a classe delegada genérica EventHandler<TEventArgs> .

Para associar o evento ao método que manipulará o evento, adicione uma instância do delegado ao evento. O manipulador de eventos é chamado sempre que o evento ocorre, a menos que você remova o delegado.

Para obter mais informações sobre representantes do manipulador de eventos, consulte Manipulando e levantando eventos.

Métodos de Extensão

Nome Description
GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Aplica-se a

Confira também