ASP.NET用戶控件入門指南
ASP以及ASP.NET歷史回顧
ASP.NET技術雖然算是從ASP演變而來的，不過使用起來確實是兩碼事。我們先看看這兩個技術的歷史：在90年代初，Microsoft為Web程序員提供的 Active Server Pages(ASP)革命性地改變了Web的編程。它可以利用十分易用的模型在Web服務器上動態生成HTML，并且很容易的實現了對數據庫的訪問，就當時來說，這是一項多么吸引人的技術，包括現在Internet上的許多web站點都是用Asp寫的，我的同事前輩們更是玩Asp的高手，經歷這么多年而不衰，可見他的成功。
但是，技術是在不斷的發展著，引用某位Net專家的話講――如今Web編程的狀態還是落后的。因此Microsoft提出了第二代編程模型――Web窗體。Web窗體模型作為Asp.net的一部分，而Asp.net又是.Net框架的一個部分。他的編程模型是基于事件的，使用他更像是在進行Windows窗體編程，這一點也正是我決定去學習使用他的一個重要原因，也胡亂看了一些這方面的書，寫這篇文章的目的也就是和各位Asp.net初學者和還沒有為用戶控件添加過自定義事件的同行分享一下經驗。
建立一個簡單的ASP.NET用戶控件
廢話少說，下面就讓我們先建立一個用戶控件吧，這里就用一個簡單登錄用戶控件來做演示。
先來看看用戶控件的前臺代碼(LogInOutControl.ascx文件)：
- < %@ Control Language="c#" AutoEventWireup="false" Codebehind="LogInOutControl.ascx.cs" Inherits="ZZ.LogInOutControl" TargetSchema="http://schemas.microsoft.com/intellisense/ie5"%>
- < TABLE id="Table1" style="FONT-SIZE: 9pt; WIDTH: 183px; HEIGHT: 125px" cellSpacing="1"
- cellPadding="1" width="183" align="center" border="1">
- < TR>
- < TD height="20">
- < asp:Label id="LabelUser" runat="server">用戶：< /asp:Label>
- < asp:TextBox id="TextBoxUserName" Width="128px" runat="server">< /asp:TextBox>< /TD>
- < /TR>
- < TR>
- < TD height="20">< FONT face="宋體">
- < asp:Label id="LabelPassword" runat="server">密碼：< /asp:Label>
- < asp:TextBox id="TextBoxPassword" Width="128px" runat="server" TextMode="Password">< /asp:TextBox>< /FONT>< /TD>
- < /TR>
- < TR>
- < TD align="center" height="20">< FONT face="宋體">
- < asp:Button id="ButtonLogIn" Width="50px" Text="登錄" runat="server">< /asp:Button>
- < asp:Button id="ButtonLogOut" Width="49px" Text="注銷" runat="server">< /asp:Button>< /FONT>< /TD>
- < /TR>
- < /TABLE>
我們簡單的放了兩個Label，兩個TextBox，兩個Button以及一個Html表。
接下去就是為LogInOutControl.ascx.cs文件添加代碼了。
首先定義一個delegate，其中LogInOutEventArgs類是從EventArgs類繼承，
- public delegate void LogInOutClickHandler(object sender,LogInOutEventArgs e);
我覺得把這個delegate放在LogInOutControl類外面更為合適。
接下去為控件聲明了LogInOutClick事件，如下：
- public event LogInOutClickHandler LogInOutClick;
另外為了更好的使用屬性，加了Language枚舉，
- private Language language;
當然外部通過public Language Lg {get;set;}屬性來訪問。目的就是改變或者獲取當前控件的顯示。
接下去就是定義控件事件觸發函數OnLogInOutClick，由按鈕單擊事件處理函數來完成對用戶控件事件的觸發。
ASP.NET用戶控件完整代碼如下：
- namespace ZZ
- {
- using System;
- using System.Data;
- using System.Drawing;
- using System.Web;
- using System.Web.UI.WebControls;
- using System.Web.UI.HtmlControls;
- // 定義代理
- public delegate void LogInOutClickHandler(object sender,LogInOutEventArgs e);
- public class LogInOutControl : System.Web.UI.UserControl
- {
- protected System.Web.UI.WebControls.Button ButtonLogIn;
- protected System.Web.UI.WebControls.TextBox TextBoxUserName;
- protected System.Web.UI.WebControls.TextBox TextBoxPassword;
- protected System.Web.UI.WebControls.Button ButtonLogOut;
- protected System.Web.UI.WebControls.Label LabelUser;
- protected System.Web.UI.WebControls.Label LabelPassword;
- public event LogInOutClickHandler LogInOutClick;
- private Language language;
- //方法
- public void ChangeLanguage(Language language)
- {
- this.Lg = language;
- }
- //屬性
- public Language Lg
- {
- set
- {
- if(value!=this.language)
- {
- if(value==Language.English)
- {
- this.LabelUser.Text = "User:";
- this.LabelPassword.Text ="Password:";
- this.ButtonLogIn.Text = "LogIn";
- this.ButtonLogOut.Text = "LogOut";
- }
- else
- {
- this.LabelUser.Text = "用戶：";
- this.LabelPassword.Text ="密碼：";
- this.ButtonLogIn.Text = "登錄";
- this.ButtonLogOut.Text = "注銷";
- }
- }
- }
- }
- private void Page_Load(object sender, System.EventArgs e)
- {
- if(this.LabelUser.Text=="User:")
- this.language = Language.English;
- else
- this.language = Language.Chinese;
- }
- private void OnLogInOutClick(object sender,LogInOutEventArgs e)
- {
- if(LogInOutClick!=null)
- LogInOutClick(this,e);
- }
- #region Web 窗體設計器生成的代碼
- override protected void OnInit(EventArgs e)
- {
- InitializeComponent();
- base.OnInit(e);
- }
- private void InitializeComponent()
- {
- this.ButtonLogIn.Click += new System.EventHandler(this.ButtonLogIn_Click);
- this.ButtonLogOut.Click += new System.EventHandler(this.ButtonLogOut_Click);
- this.Load += new System.EventHandler(this.Page_Load);
- }
- #endregion
- private void ButtonLogIn_Click(object sender, System.EventArgs e)
- {
- OnLogInOutClick(this,new LogInOutEventArgs(LogInClickType.LongIn,CustomValidate(this.TextBoxUserName.Text,this.TextBoxPassword.Text)));
- }
- private void ButtonLogOut_Click(object sender, System.EventArgs e)
- {
- //注銷代碼省略
- OnLogInOutClick(this,new LogInOutEventArgs(LogInClickType.LongOut,true));
- }
- //驗證函數
- private bool CustomValidate(string userName,string password)
- {
- //驗證代碼省略，假設通過
- return true;
- }
- }
- }
另外一個文件定義了枚舉和參數類：
- using System;
- namespace ZZ
- {
- public class LogInOutEventArgs : EventArgs
- {
- private LogInClickType type;
- private bool result;
- public LogInOutEventArgs(LogInClickType type,bool result):base()
- {
- this.type = type;
- this.result = result;
- }
- public LogInClickType Type
- {
- get{return this.type;}
- }
- //操作結果，
- public bool Result
- {
- get{return this.result;}
- }
- }
- //操作類型
- public enum LogInClickType : int
- {
- LongIn,
- LongOut
- }
- //定義語言
- public enum Language
- {
- Chinese,
- English
- }
- }
接下去看看在aspx頁面里面使用ASP.NET用戶控件。
新建一個Default.aspx頁面，拖一個LogInOutControl用戶控件到上面。
- < %@ Register TagPrefix="uc1" TagName="LogInOutControl" Src="LogInOutControl.ascx" %>
- < %@ Page language="c#" Codebehind="Default.aspx.cs" AutoEventWireup="false" Inherits="ZZ.Default" %>
- < %@ Import Namespace="ZZ" %>
- < HTML>
- < HEAD>
- < title>WebForm1< /title>
- < /HEAD>
- < body>
- < form id="Form1" method="post" runat="server">
- < FONT face="宋體">
- < uc1:LogInOutControl id="LogInOutControl1" runat="server">
- < /uc1:LogInOutControl>
- < asp:Label id="LabelMsg" runat="server">< /asp:Label>
- < asp:DropDownList id="DropDownList1" runat="server" AutoPostBack="True">
- < asp:ListItem Value="0" Selected="True">中文< /asp:ListItem>
- < asp:ListItem Value="1">英文< /asp:ListItem>
- < /asp:DropDownList>< /FONT>
- < /form>
- < /body>
- < /HTML>
在后臺代碼中添加事件和屬性。
雖然在前臺添加了LogInOutControl1，但是后臺代碼中不會生成protected LogInOutControl LogInOutControl1;這條語句，我覺得很奇怪，不管先加上他。
接著在Page_Load事件中注冊LogInOutClick事件：
- this.LogInOutControl1.LogInOutClick += new LogInOutClickHandler(LogInOutControl1_LogInOutClick);
完整代碼如下：
- using System;
- using System.Collections;
- using System.ComponentModel;
- using System.Data;
- using System.Drawing;
- using System.Web;
- using System.Web.SessionState;
- using System.Web.UI;
- using System.Web.UI.WebControls;
- using System.Web.UI.HtmlControls;
- namespace ZZ
- {
- public class Default : System.Web.UI.Page
- {
- protected System.Web.UI.WebControls.Label LabelMsg;
- protected System.Web.UI.WebControls.DropDownList DropDownList1;
- protected LogInOutControl LogInOutControl1;
- private void Page_Load(object sender, System.EventArgs e)
- {
- //注冊用戶控件事件
- this.LogInOutControl1.LogInOutClick += new LogInOutClickHandler(LogInOutControl1_LogInOutClick);
- }
- #region Web 窗體設計器生成的代碼
- override protected void OnInit(EventArgs e)
- {
- InitializeComponent();
- base.OnInit(e);
- }
- private void InitializeComponent()
- {
- this.DropDownList1.SelectedIndexChanged += new System.EventHandler(this.DropDownList1_SelectedIndexChanged);
- this.Load += new System.EventHandler(this.Page_Load);
- }
- #endregion
- private void LogInOutControl1_LogInOutClick(object sender, LogInOutEventArgs e)
- {
- switch(e.Type)
- {
- case LogInClickType.LongIn:
- this.LabelMsg.Text = "你點擊了登錄按鈕，操作結果："+e.Result.ToString();
- break;
- case LogInClickType.LongOut:
- this.LabelMsg.Text = "你點擊了注銷按鈕，操作結果："+e.Result.ToString();
- break;
- }
- }
- private void DropDownList1_SelectedIndexChanged(object sender, System.EventArgs e)
- {
- this.LogInOutControl1.Lg = (Language)this.DropDownList1.SelectedIndex;
- //this.LogInOutControl1.ChangeLanguage((Language)this.DropDownList1.SelectedIndex);
- }
- }
- }
當用戶在前臺通過選擇下拉框列表來改變控件的語言，這里通過Lg屬性來完成，不過這里也加了一個方法ChangeLanguage也可以實現同樣的功能。另外，通過點擊登陸或注銷按鈕觸發LogInOutClick事件來給頁面中的LabelMsg.Text屬性賦值從而得到操作結果。
總結，用戶控件為程序員帶來了很高的開發效率和重用性，更是在性能方面有了很大的提高，以前稱為Asp+，其實我認為Asp.net跟Asp沒有什么直接聯系。而且我想做應用程序的朋友和我一樣在開發Web程序時更喜歡采用代碼分離方式，這樣結構更清晰，便與修改和管理。同Asp程序相比，他是編譯型的，引入了面向對象的設計思想，也就不可避免的帶來了他的復雜性，要想開發高水準的Asp.net程序，對于模式的設計，層次結構的劃分，這里還是比較講究的。總之，他更像是在編Windows窗體程序，而不是在寫VB腳本。
【編輯推薦】
