جلسه پنجم آموزش ASP.NET : هندل کردن رویدادها در ASP.NET

هندل کردن رویدادها در ASP.NET

یک رویداد (event) می تواند به صورت یک action یا رخدادی همانند کلیک موس ، فشردن یک کلید ، حرکت اشاره گر موس و یا هر نوتیفیکشین تولید شده توسط سیستم باشد. یک فرآیند از طریق رویدادها ارتباط برقرار می کند. برای مثال ، وقفه ها ، رویدادهای تولید شده توسط سیستم می باشند. هنگامی که یک رویداد اتفاق می افتد ، برنامه کاربردی باید قادر به پاسخ دادن به آن یا مدیریت آن باشد.

رویدادها در ASP.NET در سمت کلاینت رخ می دهند و در سمت ماشین سرور هندل می شوند. برای مثال ، یک کاربر روی یک کلید نمایش داده شده در مرورگر کلیک می کند. در این حالت ، یک رویداد کلیک رخ می دهد. مرورگر رویداد رخ داده در سمت کلاینت را به سرور از طریق متد post ارسال می کند.

سرور یک subroutine دارد که آن چه را که در هنگام وقوع یک رویداد انجام می شود را تشریح می کند. این subroutine تحت عنوان هندلر رویداد (event-handler) نامیده می شود. بنابراین ، هنگامی که پیام رویداد به سرور انتقال داده می شود ، سرور بررسی می کند که آیا رویداد کلیک ، یک هندلر رویداد مرتبط دارد یا خیر. اگر هندلر رویداد وجود داشته باشد ، آن هندلر اجرا می شود.

آرگومان های رویداد

هندلرهای رویداد ASP.NET عموماً دو پارامتر را می گیرند و مقادیر void را برمی گردانند. پارامتر اول ، نشان دهنده شئی است که رویداد را ایجاد می کند و پارامتر دوم ، آرگومان رویداد می باشد.

Syntax کلی از یک رویداد به این صورت می باشد:

private void EventName (object sender, EventArgs e);

رویدادهای برنامه کاربردی و Session

مهم ترین رویدادهای برنامه کاربردی عبارتند از:

• Application_Start – این رویداد زمانی رخ می دهد که یک برنامه کاربردی/ وب سایت شروع به کار نماید.
• Appication_End – این رویداد زمانی رخ می دهد که یک برنامه کاربردی/ وب سایت متوقف شود.

به طور مشابه ، پرکاربردترین رویدادهای Session عبارتند از:

• Session_Start – این رویداد زمانی رخ می دهد که کاربر ابتدا یک صفحه را از برنامه کاربردی درخواست می کند.
• Session_End - این رویداد زمانی رخ می دهد که session (جلسه) به پایان برسد.

رویدادهای صفحه و کنترل

رویدادهای متداول صفحه و کنترل عبارتند از:

• DataBinding – هنگامی که یک کنترل به یک منبع داده متصل می شود ، مطرح می شود.
• Disposed – هنگامی که صفحه یا کنترلی منتشر می شود ، مطرح می شود.
• Error – این یک رویداد صفحه است و هنگامی رخ می دهد که یک مورد استثناء غیرقابل هندل بروز کند.
• Init – هنگامی که صفحه یا کنترلی مقداردهی اولیه می شود ، مطرح می شود.
• Load – هنگامی که صفحه یا کنترلی لود می شود ، مطرح می شود.
• PreRender – هنگامی که صفحه یا کنترلی رندر شده باشد ، مطرح می شود.
• Unload – هنگامی که صفحه یا کنترلی از حافظه تخلیه شود ، مطرح می شود.

هندل کردن رویداد با استفاده از کنترل ها

تمام کنترل های ASP.NET به صورت کلاسهایی پیاده سازی شده اند ، و رویدادهایی دارند که وقتی کاربر یک اقدام مشخصی را بر روی آنها انجام می دهد ، راه اندازی می شوند. برای مثال ، هنگامی که کاربر روی یک کلید کلیک می کند ، رویداد ‘Click’ تولید می شود. برای هندل کردن رویدادها ، صفت های و هندلرهای رویداد داخلی وجود دارند. هندلر رویداد ، برای پاسخ دادن به یک رویداد کدنویسی شده است و اقدام متناسبی در آن صورت می پذیرد.

به طور پیش فرض ، Visual Studio یک هندلر رویداد با ایجاد یک Handles clause در Sub procedure تولید می کند. این clause ، کنترل و رویدادی را که procedure هندل می کند ، نامگذاری می کند.

تگ ASP برای یک کنترل کلید به صورت زیر می باشد:

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

هندلر رویداد برای رویداد Click به صورت زیر می باشد :

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

   Handles btnCancel.Click
   
End Sub

یک رویداد هم چنین ، می تواند بدون Handles clause کدنویسی شود. در این صورت ، هندلر باید مطابق با صفت رویداد مناسب ، مربوط به کنترل نامگذاری شود:

تگ ASP برای کنترل کلید به این صورت است:

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

هندلر رویداد برای رویداد Click  به این صورت است:

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

End Sub

رویدادهای کنترل متداول به شرح جدول ذیل می باشند:

برخی از رویدادها باعث می شوند که بلافاصله پس از ارسال فرم به سرور ، رویدادهای callback فراخوانی شوند. مانند ، رویدادهای click مثل Button.Click .

برخی از رویدادها بلافاصله به سرور ارسال نمی شوند که رویدادهای non-postback نامیده می شوند.

برای مثال ، رویدادهای change یا رویدادهای  selection همانند TextBox.TextChanged یا CheckBox.CheckedChanged . رویدادهای nonpostback را می توان بلافاصله برای ارسال به سرور  با انجام تنظیمات خصیصه AutoPostBack به true ، ایجاد نمود.

رویدادهای پیش فرض

رویداد پیش فرض برای شیء Page ، رویداد Load می باشد. به طور مشابه ، هر کنترل ، یک رویداد پیش فرض دارد. برای مثال ، رویداد پیش فرض برای کنترل کلید ، رویداد Click می باشد.

هندلر رویداد پیش فرض می تواند در Visual Studio ایجاد شود ، تنها از طریق کلیک کردن بر control در بخش design view می توان این کار را انجام داد. جدول زیر ، برخی از رویدادهای پیش فرض برای کنترل های متداول را نشان می دهد:

مثال

این مثال شامل یک صفحه ساده با یک کنترل label و یک کنترل button در آن می باشد. از آن جایی که  رویدادهای صفحه مانند Page_Load ، Page_Init ، Page_PreRender و غیره ، اتفاق می افتند ، یک پیام ارسال می شود که توسط کنترل label نمایش داده می شود. هنگامی که کلید ، کلیک می شود ، رویداد Button_Click مطرح می شود و هم چنین یک پیام در برچسب نمایش داده می شود.

یک وب سایت جدید ایجاد کرده و از جعبه ابزار control ، کنترل label و یک کنترل button را در آن درگ می کنیم. با استفاده از پنجره properties ، شناسه های کنترل (IDs) را به ترتیب با عنوان .lblmessage. و .btnclick. تنظیم می کنیم. خصیصه Text از کنترل button را به ‘Click’ تنظیم می کنیم.

فایل نشانه گذاری (.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">
         <div>
            <asp:Label ID="lblmessage" runat="server" >
            
            </asp:Label>
            
            <br />
            <br />
            <br />
            
            <asp:Button ID="btnclick" runat="server" Text="Click" onclick="btnclick_Click" />
         </div>
      </form>
   </body>
   
</html>

برای انتقال به کد پشت صحنه فایل ، روی design view دابل کلیک می کنیم. رویداد Page_Load به طور خودکار ، بدون هیچ گونه کدی در داخلش ، ایجاد می شود. خطوط کد زیر که کدهای خود توصیف هستند را در آن می نویسیم:

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 {

   public 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 initialization event handled.<br/>";
      }
      
      protected void Page_PreRender(object sender, EventArgs e) {
         lblmessage.Text += "Page prerender event handled. <br/>";
      }
      
      protected void btnclick_Click(object sender, EventArgs e) {
         lblmessage.Text += "Button click event handled. <br/>";
      }
   }
}

صفحه را اجرا می کنیم. صفحه ، برچسب پیام های page load ، page initialization را نشان می دهد و رویدادها را پیش رندر می کند. کلید را کلیک می کنیم تا تأثیر آن را ببینیم: