萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 6 大驗證控制項深度解析與實戰指南

六大驗證控制項總覽

控制項功能核心屬性典型場景
RequiredFieldValidator必填驗證ControlToValidate, ErrorMessage, InitialValue所有必填欄位
CompareValidator比較驗證 (值比較/資料型別)ControlToValidate, ControlToCompare/ValueToCompare, Operator, Type密碼確認、數值範圍、日期比較
RangeValidator範圍驗證ControlToValidate, MinimumValue, MaximumValue, Type年齡、價格、百分比、日期區間
RegularExpressionValidator正則表達式驗證ControlToValidate, ValidationExpressionEmail、手機、身分證、郵編、URL
CustomValidator自定義邏輯驗證 (伺服端/客戶端)ControlToValidate, OnServerValidate, ClientValidationFunction複雜業務規則、資料庫唯一性、條件驗證
ValidationSummary彙總顯示所有驗證錯誤ShowSummary, ShowMessageBox, HeaderText, DisplayMode頁面頂部/彈窗顯示所有錯誤

核心屬性詳解

  • ControlToValidate:要驗證的輸入控制項 ID (必填)
  • ErrorMessage:驗證失敗顯示的文字 (在 ValidationSummary 顯示)
  • Text:驗證失敗時在控制項位置顯示的文字 (如 `*`、`!`),優先級高於 ErrorMessage
  • Display:`Static`(佔位)、`Dynamic`(不佔位、動態顯示)、`None`(不顯示、只在 Summary 顯示)
  • EnableClientScript:是否產生客戶端 JS 驗證 (預設 true,需瀏覽器支援)
  • ValidationGroup:分組驗證,按鈕同組才觸發,支援單頁多表單
  • SetFocusOnError:驗證失敗自動焦點到該控制項

實戰範例:完整註冊表單驗證

<%@ Page Language="C#" %>
<!DOCTYPE html>
<html><head><title>註冊驗證示範</title>
<style>
    .validator { color: red; font-size: 0.9em; margin-left: 5px; }
    .input-error { border-color: red !important; }
    .valid { border-color: #28a745 !important; }
    .summary { color: red; background: #fff3f3; border: 1px solid #f5c6cb; padding: 10px; margin: 10px 0; border-radius: 4px; }
</style>
</head><body>
<form id="form1" runat="server">
    <h2>會員註冊</h2>
    
    <!-- 彙總顯示 -->
    <asp:ValidationSummary ID="vsSummary" runat="server" HeaderText="請修正以下錯誤:" 
        DisplayMode="BulletList" CssClass="summary" ShowModelStateErrors="true" />
    
    <div>
        <label>用戶名 (4-16字元,字母數字底線):</label>
        <asp:TextBox ID="txtUser" runat="server" CssClass="form-control" />
        <asp:RequiredFieldValidator ControlToValidate="txtUser" Text="*" ErrorMessage="用戶名必填" 
            Display="Dynamic" CssClass="validator" runat="server" />
        <asp:RegularExpressionValidator ControlToValidate="txtUser" 
            ValidationExpression="^[a-zA-Z0-9_]{4,16}$" 
            Text="*" ErrorMessage="用戶名格式錯誤" Display="Dynamic" CssClass="validator" runat="server" />
    </div>
    
    <div>
        <label>密碼 (6-20字元,含大小寫數字):</label>
        <asp:TextBox ID="txtPwd" TextMode="Password" runat="server" />
        <asp:RequiredFieldValidator ControlToValidate="txtPwd" Text="*" ErrorMessage="密碼必填" Display="Dynamic" CssClass="validator" runat="server" />
        <asp:RegularExpressionValidator ControlToValidate="txtPwd"
            ValidationExpression="^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).{6,20}$"
            Text="*" ErrorMessage="密碼強度不足" Display="Dynamic" CssClass="validator" runat="server" />
    </div>
    
    <div>
        <label>確認密碼:</label>
        <asp:TextBox ID="txtPwd2" TextMode="Password" runat="server" />
        <asp:RequiredFieldValidator ControlToValidate="txtPwd2" Text="*" ErrorMessage="請確認密碼" Display="Dynamic" CssClass="validator" runat="server" />
        <asp:CompareValidator ControlToValidate="txtPwd2" ControlToCompare="txtPwd" 
            Operator="Equal" Type="String" Text="*" ErrorMessage="兩次密碼不一致" Display="Dynamic" CssClass="validator" runat="server" />
    </div>
    
    <div>
        <label>Email:</label>
        <asp:TextBox ID="txtEmail" runat="server" />
        <asp:RequiredFieldValidator ControlToValidate="txtEmail" Text="*" ErrorMessage="Email必填" Display="Dynamic" CssClass="validator" runat="server" />
        <asp:RegularExpressionValidator ControlToValidate="txtEmail"
            ValidationExpression="^[\w\.-]+@[\w\.-]+\.\w+$"
            Text="*" ErrorMessage="Email格式錯誤" Display="Dynamic" CssClass="validator" runat="server" />
    </div>
    
    <div>
        <label>年齡 (18-100):</label>
        <asp:TextBox ID="txtAge" runat="server" Columns="5" />
        <asp:RequiredFieldValidator ControlToValidate="txtAge" Text="*" ErrorMessage="年齡必填" Display="Dynamic" CssClass="validator" runat="server" />
        <asp:RangeValidator ControlToValidate="txtAge" Type="Integer" MinimumValue="18" MaximumValue="100"
            Text="*" ErrorMessage="年齡範圍18-100" Display="Dynamic" CssClass="validator" runat="server" />
    </div>
    
    <div>
        <label>手機號:</label>
        <asp:TextBox ID="txtMobile" runat="server" />
        <asp:RequiredFieldValidator ControlToValidate="txtMobile" Text="*" ErrorMessage="手機必填" Display="Dynamic" CssClass="validator" runat="server" />
        <asp:RegularExpressionValidator ControlToValidate="txtMobile"
            ValidationExpression="^1[3-9]\d{9}$"
            Text="*" ErrorMessage="手機格式錯誤" Display="Dynamic" CssClass="validator" runat="server" />
        <asp:CustomValidator ID="cvMobileUnique" ControlToValidate="txtMobile" 
            OnServerValidate="cvMobileUnique_ServerValidate" 
            Text="*" ErrorMessage="手機已被註冊" Display="Dynamic" CssClass="validator" runat="server" />
    </div>
    
    <asp:Button ID="btnRegister" Text="註冊" OnClick="btnRegister_Click" runat="server" ValidationGroup="register" />
    <asp:Button ID="btnCancel" Text="取消" CausesValidation="false" runat="server" />
</form>
</body></html>

後台自定義驗證 (CustomValidator)

protected void cvMobileUnique_ServerValidate(object source, ServerValidateEventArgs args)
{
    string mobile = args.Value;
    // 實際查詢資料庫
    bool exists = UserDAL.ExistsMobile(mobile); 
    args.IsValid = !exists; // false 表示驗證失敗
}

客戶端自定義驗證 (JavaScript)

<script>
function validateMobileLength(sender, args) {
    // 額外客戶端邏輯:如即時檢查手機格式 (RegexValidator 已做)、AJAX 檢查唯一性
    args.IsValid = /^1[3-9]\d{9}$/.test(args.Value);
}
</script>
<asp:CustomValidator ... ClientValidationFunction="validateMobileLength" />

驗證群組應用 (單頁多表單)

<!-- 登入表單 -->
<asp:TextBox ID="txtLoginUser" runat="server" ValidationGroup="login" />
<asp:RequiredFieldValidator ControlToValidate="txtLoginUser" ValidationGroup="login" ... />
<asp:Button ID="btnLogin" ValidationGroup="login" ... />

<!-- 註冊表單 -->
<asp:TextBox ID="txtRegUser" runat="server" ValidationGroup="register" />
<asp:RequiredFieldValidator ControlToValidate="txtRegUser" ValidationGroup="register" ... />
<asp:Button ID="btnRegister" ValidationGroup="register" ... />

進階技巧

  1. 驗證後端邏輯:`Page.IsValid` 檢查,但**永遠**在伺服端重新驗證業務規則 (客戶端可繞過)
  2. 動態啟用/停用:`validator.Enabled = false` 根據條件 (如管理員模式跳過某驗證)
  3. 手動觸發驗證:`Page.Validate("groupName")` 或 `Page.Validate()`
  4. 自定義錯誤樣式:`Page.Validators` 迴圈配合 CSS 控制輸入框紅框/綠框
  5. 非同步驗證:`CustomValidator` + `PageAsyncTask` 或 AJAX 回呼 (需配合 UpdatePanel)

常見正則表達式庫

Email: ^[\w\.-]+@[\w\.-]+\.\w+$
手機 (中國大陸): ^1[3-9]\d{9}$
身分證 (18位): ^\d{17}[\dXx]$
URL: ^https?://[\w\.-]+\.\w+(/.*)?$
IPv4: ^(\d{1,3}\.){3}\d{1,3}$ (需額外驗證各段 0-255)
郵編 (中國): ^[1-9]\d{5}$
日期 (yyyy-MM-dd): ^\d{4}-\d{2}-\d{2}$ (需配合 RangeValidator 或 CustomValidator 驗證合法性)
強密碼: ^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$

善用六大驗證控制項組合,配合 ValidationGroup、CustomValidator 雙端驗證、正則庫,可快速構建健壯、用戶友善的表單驗證體系。

copyright © 萬盛學電腦網 all rights reserved