Compartilhar via

Visão geral de eventos (Windows Forms .NET)

  • Artigo

Um evento é uma ação à qual você pode responder ou "manipular" no código. Os eventos podem ser gerados por uma ação do usuário, como clicar com o mouse ou pressionar uma tecla, pelo código do programa ou pelo sistema.

Importante

A documentação do Guia da Área de Trabalho para .NET 7 e .NET 6 está em construção.

Os aplicativos controlados por eventos executam código em resposta a um evento. Cada formulário e controle expõe um conjunto predefinido de eventos com base nos quais você pode programar. Se um desses eventos ocorrer e houver um código um manipulador de eventos associado, esse código será chamado.

Os tipos de eventos gerados por um objeto variam, mas muitos tipos são comuns à maioria dos controles. Por exemplo, a maioria dos objetos lidará com um evento Click. Se um usuário clicar em um formulário, o código no manipulador de eventos Click do formulário é executado.

Observação

Muitos eventos ocorrem com outros eventos. Por exemplo, enquanto o evento DoubleClick ocorre, os eventos MouseDown, MouseUp e Click ocorrem.

Para obter informações sobre como gerar e consumir um evento, consulte Manipulando e gerando eventos.

Delegados e sua função

Delegados são classes comumente usadas no .NET para criar mecanismos de manipulação de eventos. Os delegados equivalem aproximadamente a ponteiros de função, comumente usados no Visual C++ e em outras linguagens orientadas a objeto. No entanto, diferente dos ponteiros de função, as classes delegate são orientadas a objeto, fortemente tipadas e seguras. Além disso, quando um ponteiro de função contém apenas uma referência a uma função específica, um delegado consiste em uma referência a um objeto e referências a um ou mais métodos dentro do objeto.

Esse modelo de evento usa delegados para vincular eventos aos métodos usados para manipulá-los. A classe delegate permite que outras classes se registrem para a notificação de eventos, especificando um método de manipulador. Quando o evento ocorre, a classe delegate chama o método associado. Para obter mais informações sobre como definir representantes, consulte Manipulando e gerando eventos.

Essas classes podem ser associadas a um único método ou a vários métodos, o que chamamos de multicasting. Ao criar um representante para um evento, você normalmente cria um evento de multicast. Uma exceção rara pode ser um evento que resulta em um procedimento específico (como a exibição de uma caixa de diálogo) que não se repetiria logicamente várias vezes por evento. Para obter informações sobre como criar um representante de multicast, consulte Como combinar delegados (delegados de multicast).

Um delegado de multicast mantém uma lista de invocação dos métodos aos quais está vinculado. Essa classe é compatível com um método Combine para adicionar um método à lista de invocação e um método Remove para removê-lo.

Quando um evento é registrado pelo aplicativo, o controle gera o evento invocando a classe delegate para esse evento. A classe delegate chama o método vinculado. No caso mais comum (um delegado de multicast), o delegado chama cada método vinculado na lista de invocação por sua vez, que fornece uma notificação um-para-muitos. Essa estratégia significa que o controle não precisa manter uma lista de objetos de destino para notificação de eventos — o delegado lida com todo o registro e notificação.

Essas classes também permitem que vários eventos sejam associados ao mesmo método, permitindo uma notificação muitos para um. Por exemplo, um evento de clique de botão e um evento de clique de comando de menu podem invocar a mesma classe delegate, que chama um único método para lidar com esses eventos separados da mesma maneira.

O mecanismo de vinculação usado com delegados é dinâmico: um delegado pode ser vinculado em tempo de execução a qualquer método cuja assinatura corresponda à do manipulador de eventos. Com esse recurso, você pode configurar ou alterar o método associado de acordo com uma condição e anexar dinamicamente um manipulador de eventos a um controle.

Confira também