Como consumir eventos em um aplicativo Web FormsHow to: Consume Events in a Web Forms Application

Um cenário comum em aplicativos de Formulários Web do ASP.NET é popular uma página da Web com controles e executar uma ação específica com base no controle em que o usuário clica.A common scenario in ASP.NET Web Forms applications is to populate a webpage with controls, and then perform a specific action based on which control the user clicks. Por exemplo, um controle System.Web.UI.WebControls.Button gera um evento quando o usuário clica na página da Web.For example, a System.Web.UI.WebControls.Button control raises an event when the user clicks it in the webpage. Ao manipular o evento, o aplicativo pode executar a lógica de aplicativo apropriada para esse clique do botão.By handling the event, your application can perform the appropriate application logic for that button click.

Para tratar um evento de clique de botão em um página da WebTo handle a button click event on a webpage

  1. Crie uma página de Formulários Web do ASP.NET (página da Web) que tem um controle Button com o valor OnClick definido para o nome do método que você definirá na próxima etapa.Create a ASP.NET Web Forms page (webpage) that has a Button control with the OnClick value set to the name of method that you will define in the next step.

    <asp:Button ID="Button1" runat="server" Text="Click Me" OnClick="Button1_Click" />  
    
  2. Defina um manipulador de eventos que corresponda à assinatura de representante de evento Click e que tenha o nome que você definiu para o valor OnClick.Define an event handler that matches the Click event delegate signature and that has the name you defined for the OnClick value.

    protected void Button1_Click(object sender, EventArgs e)  
    {  
        // perform action  
    }  
    
    Protected Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click  
        ' perform action  
    End Sub  
    

    O evento Click usa a classe EventHandler para o tipo de representante e a classe EventArgs para os dados do evento.The Click event uses the EventHandler class for the delegate type and the EventArgs class for the event data. A estrutura da página ASP.NET gera automaticamente o código que cria uma instância de EventHandler e adiciona essa instância ao evento Click da instância Button.The ASP.NET page framework automatically generates code that creates an instance of EventHandler and adds this delegate instance to the Click event of the Button instance.

  3. No método do manipulador de eventos que você definiu na etapa 2, adicione código para executar as ações que são necessárias quando o evento ocorre.In the event handler method that you defined in step 2, add code to perform any actions that are required when the event occurs.

Confira tambémSee also