Permalink
Fetching contributors…
Cannot retrieve contributors at this time
55 lines (45 sloc) 2.48 KB
title ms.custom ms.date ms.prod ms.reviewer ms.suite ms.technology ms.tgt_pltfrm ms.topic helpviewer_keywords ms.assetid caps.latest.revision author ms.author manager
How to: Consume Events in a Web Forms Application
03/30/2017
.net
dotnet-standard
article
events [.NET Framework], Web Forms
Web Forms controls, and events
event handlers [.NET Framework], Web Forms
events [.NET Framework], consuming
Web Forms, event handling
73bf8638-c4ec-4069-b0bb-a1dc79b92e32
21
rpetrusha
ronpet
wpickett

How to: Consume Events in a Web Forms Application

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. For example, a xref:System.Web.UI.WebControls.Button?displayProperty=nameWithType control raises an event when the user clicks it in the webpage. By handling the event, your application can perform the appropriate application logic for that button click.

To handle a button click event on a webpage

  1. Create a ASP.NET Web Forms page (webpage) that has a xref:System.Web.UI.WebControls.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. Define an event handler that matches the xref:System.Web.UI.WebControls.Button.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  

    The xref:System.Web.UI.WebControls.Button.Click event uses the xref:System.EventHandler class for the delegate type and the xref:System.EventArgs class for the event data. The ASP.NET page framework automatically generates code that creates an instance of xref:System.EventHandler and adds this delegate instance to the xref:System.Web.UI.WebControls.Button.Click event of the xref:System.Web.UI.WebControls.Button instance.

  3. In the event handler method that you defined in step 2, add code to perform any actions that are required when the event occurs.

See Also

Events