ASP.NET 2.0 CreateUserWizard 註冊控件三大使用模式詳解

CreateUserWizard 是 ASP.NET 2.0 內建的會員註冊向導控件，封裝了完整的使用者建立流程。依據專案需求的彈性程度，主要有三種使用模式，由簡單到複雜依序為：預設模式、預設 ID 自訂模板、完全自訂 ID 模式。

模式一：預設向導功能（零程式碼）

最簡單的用法，僅需一行標記即可啟用完整註冊流程：

<asp:CreateUserWizard ID="CreateUserWizardControl" runat="server" />

特點：

• 自動產生包含使用者名稱、密碼、確認密碼、Email、安全性問題/答案的完整表單
• 內建驗證邏輯（必填、密碼強度、Email 格式等）
• 自動寫入 ASPNETDB.MDF（預設 SQL Express 會員資料庫）
• 支援續步導航、完成頁面、郵件通知等完整流程

適用情境：快速原型、標準會員註冊、無特殊業務規則需求。

模式二：使用預設 ID 自訂模板

當需要調整版面配置、加入額外驗證（如使用者名稱只能英數字），但仍想沿用內建資料繫結與儲存邏輯時，使用 ContentTemplate 自訂介面，同時保留系統預定義的控件 ID。

系統預定義的必要控件 ID

範例：自訂版面並加入 RegularExpressionValidator

<asp:CreateUserWizard ID="CreateUserWizardControl" runat="server">
  <WizardSteps>
    <asp:CreateUserWizardStep ID="CreateUserWizardStep1" runat="server" Title="帳號資訊">
      <ContentTemplate>
        使用者名稱：
        <asp:TextBox ID="UserName" runat="server" />
        <asp:RequiredFieldValidator ControlToValidate="UserName" ValidationGroup="CreateUserWizardControl"
             ErrorMessage="請輸入使用者名稱" Display="Dynamic" />
        <asp:RegularExpressionValidator ControlToValidate="UserName" ValidationGroup="CreateUserWizardControl"
             ValidationExpression="^[a-zA-Z0-9]+$" ErrorMessage="僅限英數字" Display="Dynamic" />
        <br />
        密碼：
        <asp:TextBox ID="Password" TextMode="Password" runat="server" />
        <br />
        確認密碼：
        <asp:TextBox ID="ConfirmPassword" TextMode="Password" runat="server" />
      </ContentTemplate>
    </asp:CreateUserWizardStep>
  </WizardSteps>
</asp:CreateUserWizard>

優點：保留內建的 CreateUser 事件處理、資料庫寫入、錯誤訊息顯示等功能。缺點：版面結構受限於預定義 ID，無法隨意更改控件命名。

模式三：完全自訂 ID（手動處理一切）

若專案要求控件 ID 必須符合特定命名規範（如 myName、myPassword），系統將無法自動辨識，開發者必須自行處理完整流程：

1. 從自訂控件取得輸入值（FindControl 或直接參考）
2. 執行伺服器端驗證（商業邏輯、資料庫唯一性檢查等）
3. 建立資料庫連線（SqlConnection / Membership.CreateUser）
4. 寫入使用者資料
5. 關閉連線、處理例外、導向結果頁

程式碼範例（概念示意）

protected void btnRegister_Click(object sender, EventArgs e)
{
    string userName = ((TextBox)FindControl("myName")).Text;
    string password = ((TextBox)FindControl("myPassword")).Text;
    string email = ((TextBox)FindControl("myEmail")).Text;

    try
    {
        MembershipCreateStatus status;
        Membership.CreateUser(userName, password, email, null, null, true, out status);
        if (status == MembershipCreateStatus.Success)
            Response.Redirect("RegisterSuccess.aspx");
        else
            ShowError(status);
    }
    catch (Exception ex)
    {
        LogError(ex); ShowGenericError();
    }
}

三種模式比較總覽

最佳實務建議

1. 優先評估預設模式是否滿足需求，避免過度工程
2. 需調整版面或加入驗證時，採用模式二，善用 ValidationGroup 確保驗證群組正確
3. 唯有在企業命名規範強制要求或極度複雜業務流程時，才採用模式三
4. 無論哪種模式，建議集中管理 web.config 中的 membership 設定（密碼策略、鎖定機制等）

善用 CreateUserWizard 的三種模式，能在開發效率與彈性間取得最佳平衡，避免重複造輪子。