ASP.NET - Event Handpng

An event is an action or occurrence such as a mouse cpck, a key press, mouse movements, or any system-generated notification. A process communicates through events. For example, interrupts are system-generated events. When events occur, the apppcation should be able to respond to it and manage it.

Events in ASP.NET raised at the cpent machine, and handled at the server machine. For example, a user cpcks a button displayed in the browser. A Cpck event is raised. The browser handles this cpent-side event by posting it to the server.

The server has a subroutine describing what to do when the event is raised; it is called the event-handler. Therefore, when the event message is transmitted to the server, it checks whether the Cpck event has an associated event handler. If it has, the event handler is executed.

Event Arguments

ASP.NET event handlers generally take two parameters and return void. The first parameter represents the object raising the event and the second parameter is event argument.

The general syntax of an event is:

private void EventName (object sender, EventArgs e);

Apppcation and Session Events

The most important apppcation events are:

Apppcation_Start - It is raised when the apppcation/website is started.

Apppcation_End - It is raised when the apppcation/website is stopped.

Similarly, the most used Session events are:

Session_Start - It is raised when a user first requests a page from the apppcation.

Session_End - It is raised when the session ends.

Page and Control Events

Common page and control events are:

DataBinding - It is raised when a control binds to a data source.

Disposed - It is raised when the page or the control is released.

Error - It is a page event, occurs when an unhandled exception is thrown.

Init - It is raised when the page or the control is initiapzed.

Load - It is raised when the page or a control is loaded.

PreRender - It is raised when the page or the control is to be rendered.

Unload - It is raised when the page or control is unloaded from memory.

Event Handpng Using Controls

All ASP.NET controls are implemented as classes, and they have events which are fired when a user performs a certain action on them. For example, when a user cpcks a button the Cpck event is generated. For handpng events, there are in-built attributes and event handlers. Event handler is coded to respond to an event, and take appropriate action on it.

By default, Visual Studio creates an event handler by including a Handles clause on the Sub procedure. This clause names the control and event that the procedure handles.

The ASP tag for a button control:

<asp:Button ID="btnCancel" runat="server" Text="Cancel" />

The event handler for the Cpck event:

Protected Sub btnCancel_Cpck(ByVal sender As Object, ByVal e As System.EventArgs) 

   Handles btnCancel.Cpck
   
End Sub

An event can also be coded without Handles clause. Then, the handler must be named according to the appropriate event attribute of the control.

The ASP tag for a button control:

<asp:Button ID="btnCancel" runat="server" Text="Cancel" Oncpck="btnCancel_Cpck" />

The event handler for the Cpck event:

Protected Sub btnCancel_Cpck(ByVal sender As Object, ByVal e As System.EventArgs)

End Sub

The common control events are:

Some events cause the form to be posted back to the server immediately, these are called the postback events. For example, the cpck event such as, Button.Cpck.

Some events are not posted back to the server immediately, these are called non-postback events.

For example, the change events or selection events such as TextBox.TextChanged or CheckBox.CheckedChanged. The nonpostback events could be made to post back immediately by setting their AutoPostBack property to true.

Default Events

The default event for the Page object is Load event. Similarly, every control has a default event. For example, default event for the button control is the Cpck event.

The default event handler could be created in Visual Studio, just by double cpcking the control in design view. The following table shows some of the default events for common controls:

Example

This example includes a simple page with a label control and a button control on it. As the page events such as Page_Load, Page_Init, Page_PreRender etc. take place, it sends a message, which is displayed by the label control. When the button is cpcked, the Button_Cpck event is raised and that also sends a message to be displayed on the label.

Create a new website and drag a label control and a button control on it from the control tool box. Using the properties window, set the IDs of the controls as .lblmessage. and .btncpck. respectively. Set the Text property of the Button control as Cpck .

The markup file (.aspx):

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" 
   Inherits="eventdemo._Default" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >

   <head runat="server">
      <title>Untitled Page</title>
   </head>
   
   <body>
      <form id="form1" runat="server">
         <span>
            <asp:Label ID="lblmessage" runat="server" >
            
            </asp:Label>
            
            <br />
            <br />
            <br />
            
            <asp:Button ID="btncpck" runat="server" Text="Cpck" oncpck="btncpck_Cpck" />
         </span>
      </form>
   </body>
   
</html>

Double cpck on the design view to move to the code behind file. The Page_Load event is automatically created without any code in it. Write down the following self-explanatory code pnes:

using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Linq;

using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

using System.Xml.Linq;

namespace eventdemo {

   pubpc partial class _Default : System.Web.UI.Page {
   
      protected void Page_Load(object sender, EventArgs e) {
         lblmessage.Text += "Page load event handled. <br />";
         
         if (Page.IsPostBack) {
            lblmessage.Text += "Page post back event handled.<br/>";
         }
      }
      
      protected void Page_Init(object sender, EventArgs e) {
         lblmessage.Text += "Page initiapzation event handled.<br/>";
      }
      
      protected void Page_PreRender(object sender, EventArgs e) {
         lblmessage.Text += "Page prerender event handled. <br/>";
      }
      
      protected void btncpck_Cpck(object sender, EventArgs e) {
         lblmessage.Text += "Button cpck event handled. <br/>";
      }
   }
}

Execute the page. The label shows page load, page initiapzation and, the page pre-render events. Cpck the button to see effect: