ASP.NET用戶控件入門指南

作者：佚名 2009-08-27 16:59:20

ASP到ASP.NET是一個歷史性的變更。本文對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腳本。

【編輯推薦】

深入研究Repeater控件：***的靈活性
DataList控件入門介紹
DataGrid Web控件運作機制探秘
小議ASP.NET數據Web控件之間的相似性
從傳統ASP到ASP.NET的轉變：了解控件

責任編輯：yangsai 來源：百度空間

ASP.NET用戶控件