程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> ASP.NET基礎 >> ASP.NET服務器控件開發(1)封裝html

ASP.NET服務器控件開發(1)封裝html

編輯:ASP.NET基礎

在我們的項目開發中,由於ASP.NET的服務器控件功能有限,所以我們經常會自己定義特定的服務器控件,來滿足開發中特定的業務要求。可見知道如何開發ASP.NET服務器控件是非常有必要的。

其實簡單的實現ASP.NET服務器控件不是很難,以前園子中也有大牛介紹過相應的內容,這裡站在巨人的肩膀上也來分享下開發ASP.NET服務器控件的方法和自己的一些體會。寫給新手,高手繞過。

學習ASP.NET的服務器控件開發,個人認為最好的方式就是自己去實踐,當然理論知識也是很重要的,但是如果我們只是看理論的知識,可能會被裡面的一些概念鬧糊塗,看著看著就睡著了,如果自己動手創做出一個自己的控件,效果就不一樣了。

下面就通過實例創建一個簡單的服務器控件:

首先我們創建一個類庫工程SelfWebControl。在同一解決方案中我們在創建一個ASP,NET Web應用程序(用來測試我們得控件)

namespace SelfWebControl
{
  public class ControlA:Control//Control類中定義了所有ASP.NET服務器控件共享的屬性和方法
  {

  }
}

我將ControlA類繼承Control類,Control類是.NET中所有控件的基類,其中包含了控件共有的屬性和方法。

Control類

公共屬性:

ClientID 獲取由 ASP.NET 生成的服務器控件標識符。

Controls 獲取 ControlCollection 對象,該對象表示 UI 層次結構中指定服務器控件的子控件。

EnableViewState 獲取或設置一個值,該值指示服務器控件是否向發出請求的客戶端保持自己的視圖狀態以及它所包含的任何子控件的視圖狀態。

ID 獲取或設置分配給服務器控件的編程標識符。

NamingContainer 獲取對服務器控件的命名容器的引用,此引用創建唯一的命名空間,以區分具有相同 Control.ID 屬性值的服務器控件。

Page 獲取對包含服務器控件的 Page 實例的引用。

Parent 獲取對頁 UI 層次結構中服務器控件的父控件的引用。

Site 獲取有關服務器控件所屬 Web 站點的信息(原文自MSDN,但是我認為不對,應該是指組件的“容器”站點,並非 web site)。

TemplateSourceDirectory 獲取包含當前服務器控件的 Page 或 UserControl 的虛擬目錄。

UniqueID 獲取服務器控件的唯一的、以分層形式限定的標識符。

Visible 獲取或設置一個值,該值指示服務器控件是否作為 UI 呈現在頁上。

公共方法:

DataBind 將數據源綁定到被調用的服務器控件及其所有子控件。

Dispose 使服務器控件得以在從內存中釋放之前執行最後的清理操作。

Equals(從 Object 繼承) 已重載。確定兩個 Object 實例是否相等。

FindControl 已重載。在當前的命名容器中搜索指定的服務器控件。

GetHashCode(從 Object 繼承) 用作特定類型的哈希函數,適合在哈希算法和數據結構(如哈希表)中使用。

GetType(從 Object 繼承) 獲取當前實例的 Type。

HasControls 確定服務器控件是否包含任何子控件。

RenderControl 將服務器控件的內容輸出到所提供的 HtmlTextWriter 對象中;如果已啟用跟蹤功能,則存儲有關控件的跟蹤信息。

ResolveUrl 根據傳遞給 TemplateSourceDirectory 屬性的值,將相對 URL 解析為絕對 URL。

ToString(從 Object 繼承) 返回表示當前 Object 的 String。

公共事件:

DataBinding 當服務器控件綁定到數據源時發生。

Disposed 當從內存釋放服務器控件時發生,這是請求 ASP.NET 頁時服務器控件生存期的最後階段。

Init 當服務器控件初始化時發生;初始化是控件生存期的第一步。服務器控件應執行任何創建和設置實例所需的初始化步驟。在該事件內無法使用視圖狀態信息;它尚未填充。在該事件的生存期內不應訪問其他服務器控件,不論它是此控件的子級還是父級。不一定會創建其他服務器控件,也不一定能夠訪問它們。

Load 當服務器控件加載到 Page 對象中時發生。通知服務器控件執行任何設置為在每次頁請求時發生的處理步驟。開發者可以訪問視圖狀態信息並利用該事件形成 POST 數據。還可以訪問頁控件層次結構內的其他服務器控件。

PreRender 當服務器控件將要呈現給其包含的 Page 對象時發生。使用該事件在服務器控件呈現給頁的輸出之前執行任何更新。在該事件的生存期內可以保存服務器控件視圖狀態的任何更改。不保存呈現階段內所做的同樣更改。

Unload 當服務器控件從內存中卸載時發生。

保護的屬性:

ChildControlsCreated 獲取一個值,該值指示是否已創建服務器控件的子控件。

Context 為當前 Web 請求獲取與服務器控件關聯的 HttpContext 對象。

Events 獲取控件的事件處理程序委托列表。此屬性為只讀。

HasChildViewState 獲取一個值,該值指示當前服務器控件的子控件是否具有任何已保存的視圖狀態設置。

IsTrackingViewState 獲取一個值,該值指示服務器控件是否將更改保存到其視圖狀態。

ViewState 獲取狀態信息的字典,這些信息使您可以在同一頁的多個請求間保存和還原服務器控件的視圖狀態。

ViewStateIgnoresCase 獲取一個值,該值指示 StateBag 對象是否不區分大小寫。

受保護的方法:

AddParsedSubObject 通知服務器控件某個元素(XML 或 HTML)已經過語法分析,並將該元素添加到服務器控件的 ControlCollection 對象。

ClearChildViewState 刪除服務器控件的所有子控件的視圖狀態信息。

CreateChildControls 通知使用基於合成的實現的服務器控件創建它們包含的任何子控件,以便為回發或呈現做准備。

CreateControlCollection 創建一個新的 ControlCollection 對象來保存服務器控件的子控件(包括文本控件和服務器控件)。

EnsureChildControls 確定服務器控件是否包含子控件。如果不包含,則創建子控件。

Finalize(從 Object 繼承) 已重寫。允許 Object 在“垃圾回收”回收 Object 之前嘗試釋放資源並執行其他清理操作。

IsLiteralContent 確定服務器控件是否只包含文字內容。Asp.net頁面中普通的html標簽被asp.net編譯為一個 LiteralContent控件(意味著輕型控件)。

LoadViewState 從 SaveViewState 方法保存的上一個頁請求還原視圖狀態信息。

MapPathSecure 如果請求服務器控件有足夠的安全權限讀取映射結果,檢索相對於源文件的映射物理文件路徑。

MemberwiseClone(從 Object 繼承) 創建當前 Object 的淺表副本。

OnBubbleEvent 確定服務器控件的事件是否沿頁的 UI 服務器控件層次結構向上傳遞。

OnDataBinding 引發 DataBinding 事件。

OnInit 引發 Init 事件。

OnLoad 引發 Load 事件。

OnPreRender 引發 PreRender 事件。

OnUnload 引發 Unload 事件。 注意 在服務器控件生存期的此階段,服務器控件應執行所有最後的清理操作,例如關閉文件、關閉數據庫連接和丟棄對象。

RaiseBubbleEvent 將所有事件源及其信息分配給控件的父級。

Render 將服務器控件內容發送到提供的 HtmlTextWriter 對象,此對象編寫將在客戶端呈現的內容。

RenderChildren 將服務器控件子級的內容輸出到提供的 HtmlTextWriter 對象,此對象編寫將在客戶端呈現的內容。

SaveViewState 保存自頁回發到服務器後發生的任何服務器控件視圖狀態更改。

TrackViewState 導致跟蹤服務器控件的視圖狀態的更改,以便這些更改可以存儲到服務器控件的 StateBag 對象中。通過 Control.ViewState 屬性可訪問此對象。


這裡我們要重寫Render方法,通過HtmlTextWriter 對象將控件中的內容顯示出去。

namespace SelfWebControl
{
  public class ControlA:Control//Control類中定義了所有ASP.NET服務器控件共享的屬性和方法
  {
    protected override void Render(HtmlTextWriter writer)
    {
      writer.Write("<table style='width:300px; height:200px; background-color:Bisque'>");
      writer.Write("<tr>");
      writer.Write("<td>這是第一列</td>");
      writer.Write("<td>這是第二列</td>");
      writer.Write("<td>這是第三列</td>");
      writer.Write("</tr>");
      writer.Write("</table>");
    }
  }
}

生成我們得SelfWebControl工程,再切換到ASP.NET應用程序的工具箱時,VS2008會自動的將我們剛剛創建的ControlA添加到工具箱中,避免了我們以前通過選擇項添加控件的過程。

這樣,我們就已最簡單的形式實現了一個ASP.NET服務器控件。但是如果我想修改表格的寬度,高度,背景色該怎麼改呢?

這就需要我們定義服務器控件的屬性。大家也都知道,ASP.NET的服務器控件有很多屬性,而我們現在的控件只有公有的幾個屬性。

先來看看我們做了那些改動:

public class ControlA:Control//Control類中定義了所有ASP.NET服務器控件共享的屬性和方法
  {
    private int _tWidth;
    private int _tHeight;
    private string _bgColor;

    
    [Browsable(true)]//在屬性窗口中是否可見
    [Category("Appearance")]//屬性的分類,如,行為,外觀,大家可以在屬性窗口看見這樣的分類
    [DefaultValue(100)]//屬性的默認值
    [Description("表格寬度")]//這些是顯示在屬性窗口底下的
    public int tWidth
    {
      get { return _tWidth; }
      set { _tWidth = value; }
    }

    [Browsable(true)]
    [Category("Appearance")]
    [DefaultValue(100)]
    [Description("表格高度")]
    public int tHeight
    {
      get { return _tHeight; }
      set { _tHeight = value; }
    }

    [Browsable(true)]
    [Category("Appearance")]
    [DefaultValue("Bisque")]
    [Description("表格背景顏色")]
    public string bgColor
    {
      get { return _bgColor; }
      set { _bgColor = value; }
    }

    protected override void Render(HtmlTextWriter writer)
    {
      writer.Write("<table style='width:" + tWidth + "px; height:"+tHeight+"px; background-color:"+bgColor+"'>");
      writer.Write("<tr>");
      writer.Write("<td>這是第一列</td>");
      writer.Write("<td>這是第二列</td>");
      writer.Write("<td>這是第三列</td>");
      writer.Write("</tr>");
      writer.Write("</table>");
    }
  }

代碼很簡單,想必大家都能看懂,值得注意的就是對每一個屬性的聲明。需要引用命名空間:using System.ComponentModel;每一個標簽的作用我已經在代碼中做了說明,這樣我們就為我們得控件添加了屬性.

還要說明一點的就是,如果我們想在把控件拖到頁面中時標簽內自動的添加一些屬性,需要添加下面的代碼:

復制代碼 代碼如下:
[ToolboxData("<{0}:ControlA runat='server' bgColor='red' tHeight='200' tWidth='300'></{0}:ControlA>")]

值得注意的是這裡的寫法,{0}的冒號中之後的那個"ControlA“就是類的名字,不要寫錯。還有runat='sever'一定要寫。

是不是很簡單,這樣,我們只是封裝了簡單的html來完成ASP.NET控件的制作。

小結:簡單的制作一個ASP.NET的服務器控件很簡單,但是光只是通過html的輸出有的時候意義不大,這裡只是介紹一種方法和思路。打開學習定制自己的ASP.NET控件的第一扇門。在以後的文章中我會介紹針對於繼承WebControl開發ASP.NET控件。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved