Instrução AddHandler

Associa um evento com um manipulador de eventos em tempo de execução.

AddHandler event, AddressOf eventhandler

Partes

• event
  O nome do evento para manipular.

• eventhandler
  O nome de um procedimento que manipula o evento.

Comentários

O AddHandler e RemoveHandler instruções permitem iniciar e parar manipulação de eventos a qualquer momento durante a execução do programa.

A assinatura da eventhandler procedimento deve corresponder à assinatura do evento event.

A palavra-chave Handles e a instrução AddHandler ambas permitem que você especifique que determinados procedimentos manipulem eventos específicos, mas há diferenças.A instrução AddHandler conecta os procedimentos a eventos em tempo de execução.Use a palavra-chave Handles ao definir um procedimento para especificar que ele manipula um evento específico.Para obter mais informações, consulte Cláusula Handles (Visual Basic).

Observação
Para eventos personalizados, a instrução AddHandler chama o evento do acessador AddHandler.Para obter mais informações sobre eventos personalizados, consulte Declaração de evento.

Exemplo

Sub TestEvents()
    Dim Obj As New Class1
    ' Associate an event handler with an event.
    AddHandler Obj.Ev_Event, AddressOf EventHandler
    ' Call the method to raise the event.
    Obj.CauseSomeEvent()
    ' Stop handling events.
    RemoveHandler Obj.Ev_Event, AddressOf EventHandler
    ' This event will not be handled.
    Obj.CauseSomeEvent()
End Sub

Sub EventHandler()
    ' Handle the event.
    MsgBox("EventHandler caught event.")
End Sub

Public Class Class1
    ' Declare an event.
    Public Event Ev_Event()
    Sub CauseSomeEvent()
        ' Raise an event.
        RaiseEvent Ev_Event()
    End Sub
End Class

Consulte também

Referência

Instrução RemoveHandler

Cláusula Handles (Visual Basic)

Declaração de evento

Outros recursos

Eventos (Visual Basic)