ASP.NET 驗證控制項深度解析：RegularExpressionValidator 與 CustomValidator

前言

ASP.NET WebForms 內建驗證控制項提供聲明式的客戶端/伺服器端雙重驗證機制。本文深度解析兩大核心控制項：RegularExpressionValidator (正則表達式驗證) 與 CustomValidator (自定義邏輯驗證)，並附贈常用正則表達式速查表。

一、RegularExpressionValidator：正則驗證專家

1.1 基本語法

<asp:RegularExpressionValidator 
    ID="revEmail" 
    runat="server" 
    ControlToValidate="txtEmail" 
    ValidationExpression="\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*"
    ErrorMessage="郵件格式不正確"
    Display="Dynamic"
    CssClass="text-danger"
    SetFocusOnError="true">
</asp:RegularExpressionValidator>

1.2 核心屬性

1.3 常用正則表達式速查表

1.4 正則元字元快速參考

二、CustomValidator：自定義業務邏輯驗證

2.1 伺服器端驗證 (ServerValidate)

<asp:CustomValidator 
    ID="cvUserName" 
    runat="server" 
    ControlToValidate="txtUserName" 
    OnServerValidate="cvUserName_ServerValidate"
    ErrorMessage="此帳號已被註冊"
    Display="Dynamic"
    CssClass="text-danger">
</asp:CustomValidator>

protected void cvUserName_ServerValidate(object source, ServerValidateEventArgs args)
{
    string inputValue = args.Value; // 使用者輸入的值
    
    // 業務邏輯：檢查資料庫是否存在
    using (var conn = new SqlConnection(ConnString))
    using (var cmd = new SqlCommand("SELECT COUNT(*) FROM Users WHERE UserName = @Name", conn))
    {
        cmd.Parameters.AddWithValue("@Name", inputValue);
        conn.Open();
        int count = (int)cmd.ExecuteScalar();
        
        args.IsValid = (count == 0); // true = 驗證通過，false = 失敗
    }
}

2.2 客戶端驗證 (ClientValidationFunction)

<asp:CustomValidator 
    ID="cvPassword" 
    runat="server" 
    ControlToValidate="txtPassword" 
    ClientValidationFunction="validatePasswordStrength"
    OnServerValidate="cvPassword_ServerValidate"
    ErrorMessage="密碼強度不足">
</asp:CustomValidator>

<script>
function validatePasswordStrength(sender, args) {
    var value = args.Value;
    // 客戶端邏輯：至少 8 碼、含大小寫、數字
    var regex = /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{8,}$/;
    args.IsValid = regex.test(value);
}
</script>

2.3 無 ControlToValidate 的表單級驗證

驗證多個欄位關聯邏輯 (如「確認密碼」)：

<asp:CustomValidator 
    ID="cvConfirmPassword" 
    runat="server" 
    ClientValidationFunction="validatePasswordMatch"
    OnServerValidate="cvConfirmPassword_ServerValidate"
    ErrorMessage="兩次密碼不一致"
    Display="Dynamic">
</asp:CustomValidator>

<script>
function validatePasswordMatch(sender, args) {
    var pwd = document.getElementById('<%= txtPassword.ClientID %>').value;
    var confirm = document.getElementById('<%= txtConfirmPassword.ClientID %>').value;
    args.IsValid = (pwd === confirm && pwd.length > 0);
}
</script>

三、驗證群組與按鈕觸發

<!-- 登入區塊 -->
<asp:TextBox ID="txtLoginName" runat="server" ValidationGroup="LoginGroup" />
<asp:RequiredFieldValidator ControlToValidate="txtLoginName" ValidationGroup="LoginGroup" ... />
<asp:Button ID="btnLogin" runat="server" Text="登入" ValidationGroup="LoginGroup" />

<!-- 註冊區塊 -->
<asp:TextBox ID="txtRegName" runat="server" ValidationGroup="RegGroup" />
<asp:RequiredFieldValidator ControlToValidate="txtRegName" ValidationGroup="RegGroup" ... />
<asp:Button ID="btnRegister" runat="server" Text="註冊" ValidationGroup="RegGroup" />

四、手動觸發驗證與檢查結果

protected void btnSubmit_Click(object sender, EventArgs e)
{
    // 1. 執行特定群組驗證
    Page.Validate("RegGroup"); 
    
    // 2. 或執行所有驗證
    Page.Validate(); 
    
    // 3. 檢查整體是否通過
    if (Page.IsValid)
    {
        // 全部通過，執行業務邏輯
        SaveData();
    }
    else
    {
        // 有失敗，可遍歷 Validators 收集錯誤
        foreach (BaseValidator validator in Page.Validators)
        {
            if (!validator.IsValid)
            {
                // 記錄或處理 validator.ErrorMessage
            }
        }
    }
}

五、驗證控制項最佳實踐

• 雙重驗證：啟用 `EnableClientScript="true"` (預設) 獲得即時回饋，伺服器端 `Page.IsValid` 為最終防線。
• 錯誤訊息集中顯示：使用 `` 彙總顯示所有錯誤。
• 避免過度依賴正則：複雜業務規則 (如跨欄位、資料庫查詢) 改用 CustomValidator。
• 效能考量：CustomValidator 伺服器端驗證涉及資料庫查詢，避免在大量資料綁定場景 (GridView RowDataBound) 中使用。
• 無障礙：搭配 `ValidationSummary`、`SetFocusOnError`、ARIA 屬性提升可用性。

六、現代化替代：Data Annotations + Model 驗證 (MVC/Core)

public class RegisterViewModel
{
    [Required(ErrorMessage = "請輸入帳號")]
    [StringLength(20, MinimumLength = 4, ErrorMessage = "帳號長度 4-20 碼")]
    [Remote("CheckUserName", "Account", ErrorMessage = "帳號已存在")] // AJAX 遠端驗證
    public string UserName { get; set; }

    [Required(ErrorMessage = "請輸入 Email")]
    [EmailAddress(ErrorMessage = "Email 格式錯誤")]
    public string Email { get; set; }

    [Required(ErrorMessage = "請輸入密碼")]
    [DataType(DataType.Password)]
    [StringLength(16, MinimumLength = 8, ErrorMessage = "密碼長度 8-16 碼")]
    [RegularExpression(@"^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).+$", ErrorMessage = "需含大小寫字母與數字")]
    public string Password { get; set; }

    [Compare("Password", ErrorMessage = "兩次密碼不一致")]
    [DataType(DataType.Password)]
    public string ConfirmPassword { get; set; }
}

總結

ASP.NET 驗證控制項提供了聲明式、雙端同步的驗證機制。RegularExpressionValidator 適合格式驗證，配合豐富的正則庫可覆蓋 90% 輸入檢查需求；CustomValidator 處理複雜業務規則、跨欄位驗證、資料庫查重。掌握正則元字元、驗證群組、手動觸發、ValidationSummary 等進階用法，即可構建健壯的表單驗證體系。新專案建議遷移至 MVC/Core 的 Data Annotations + FluentValidation 架構。