ASP.NET 2.0 伺服器控制項開發入門：建立自訂 Web 控制項庫專案與測試網站完整流程

ASP.NET 2.0 搭配 Visual Studio 2005，提供完整的自訂伺服器控制項開發環境。本文詳細記錄從建立測試網站、新增 Web 控制項庫專案、編寫控制項程式碼、編譯到測試驗證的完整標準流程。

開發環境準備

• Visual Studio 2005（Standard/Professional/Team Suite）
• .NET Framework 2.0
• IIS 或內建開發伺服器（檔案系統網站）

步驟一：建立測試用 Web 網站專案

1. VS 2005 → 「檔案」→「新建網站」。
2. 範本：「ASP.NET 網站」，位置：「檔案系統」，語言：C#，路徑：D:\AppTest\test1。
3. 點擊「確定」，自動產生 Default.aspx、Default.aspx.cs、App_Data 資料夾。

步驟二：新增 Web 控制項庫專案

1. 在開啟的網站方案上右鍵 → 「加入」→「新建專案」（或「檔案」→「加入」→「新建專案」）。
2. 專案類型：「Visual C#」→「Windows」→「Web 控制項庫」。
3. 名稱：HelloMyControl，位置：D:\AppTest\test1（與測試網站同目錄便於管理）。
4. 點擊「確定」，方案總管顯示兩個專案：test1（網站）、HelloMyControl（控制項庫）。

控制項庫預設包含 WebCustomControl1.cs，繼承 System.Web.UI.WebControls.WebControl。

步驟三：編寫自訂控制項程式碼

修改 WebCustomControl1.cs，實作簡易 HelloWorld 控制項：

[DefaultProperty("Text")]
[ToolboxData("<{0}:HelloWorld runat=server>")]
public class HelloWorld : WebControl
{
    [Bindable(true)]
    [Category("Appearance")]
    [DefaultValue("")]
    [Localizable(true)]
    public string Text
    {
        get { return (string)ViewState["Text"]; }
        set { ViewState["Text"] = value; }
    }

    protected override void RenderContents(HtmlTextWriter output)
    {
        output.Write(Text);
    }
}

步驟四：編譯控制項庫

• 方案總管右鍵 HelloMyControl 專案 → 「建置」。
• 輸出組件 HelloMyControl.dll 位於專案 bin\Debug 或 bin\Release。

步驟五：測試網站引用與使用控制項

1. 測試網站 test1 右鍵 → 「加入參考」→「專案」頁籤 → 選擇 HelloMyControl。
2. 在 Default.aspx 註冊標籤前綴：

<%@ Register Assembly="HelloMyControl" Namespace="HelloMyControl" TagPrefix="cc1" %>

3. 拖放或手寫控制項標記：

<cc1:HelloWorld ID="HelloWorld1" runat="server" Text="Hello, Custom Control!" />

4. 執行網站（F5），瀏覽器顯示「Hello, Custom Control!」。

進階：將控制項加入工具箱

1. 工具箱右鍵 → 「選擇項目」→「.NET Framework 元件」頁籤 → 「瀏覽」選擇 HelloMyControl.dll。
2. 控制項圖示出現在工具箱，可直接拖放至設計介面。

除錯技巧

• 方案屬性 → 「啟始專案」設為「目前選取專案」，同時啟用網站與控制項庫專案除錯。
• 控制項庫程式碼設中斷點，網站執行時命中即可單步除錯。
• 修改控制項庫程式碼後重新建置，網站自動複製新版組件至 bin。

部署注意事項

• 生產環境僅需部署 HelloMyControl.dll 至網站 bin 目錄或 GAC。
• 建議強名稱簽章組件，啟用版本控管與並存。
• 配合 web.config <pages> <controls> 區段全站註冊標籤前綴，免去每頁 @Register。

掌握此標準流程，即可開始建構可重用、可維護、設計工具友善的企業級自訂伺服器控制項庫。