萬盛學電腦網

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

ASP.NET 解決驗證控制項與自訂 JavaScript 驗證衝突:Page_ClientValidate 整合技巧

前言

ASP.NET 驗證控制項(RequiredFieldValidator 等)產生的客戶端腳本使用 Page_ClientValidate() 統一驗證,若同時需要自訂 JavaScript 驗證(如密碼強度、確認密碼比對),必須正確整合避免衝突。本文提供標準整合模式。

核心原理

  • Page_ClientValidate():執行所有驗證控制項的客戶端驗證,設定全域 Page_IsValid (Boolean)。
  • 按鈕 OnClientClick 回傳 false 可取消 PostBack/回發。
  • 驗證群組:ValidationGroup 區分不同區塊驗證,Page_ClientValidate('GroupName')。

標準整合模式

<asp:Button ID="btnSubmit" runat="server" Text="送出"
     OnClick="btnSubmit_Click"
     OnClientClick="return ValidateAll();"
     ValidationGroup="RegisterGroup" />

<script type="text/javascript">
function ValidateAll() {
    // 1. 執行 ASP.NET 內建驗證(指定群組)
    var aspNetValid = Page_ClientValidate('RegisterGroup');
    
    // 2. 自訂 JavaScript 驗證
    var customValid = ValidateCustomRules();
    
    // 3. 兩者皆通過才允許提交
    return aspNetValid && customValid;
}

function ValidateCustomRules() {
    var pwd = document.getElementById('<%= txtPassword.ClientID %>').value;
    var confirm = document.getElementById('<%= txtConfirm.ClientID %>').value;
    
    if (pwd.length < 8) {
        alert('密碼至少 8 碼');
        return false;
    }
    if (pwd !== confirm) {
        alert('兩次密碼不一致');
        return false;
    }
    // 密碼強度正則...
    return true;
}
</script>

進階:非同步驗證(AJAX 檢查帳號唯一)

function ValidateCustomRules() {
    var account = $('#<%= txtAccount.ClientID %>').val();
    var result = true;
    
    $.ajax({
        url: '/Api/CheckAccount',
        type: 'POST',
        async: false, // 同步等待(不推薦,示範邏輯)
        data: { account: account },
        success: function(res) {
            if (!res.available) {
                alert('帳號已存在');
                result = false;
            }
        }
    });
    return result;
}

⚠️ async: false 會阻塞 UI,**生產環境建議**:按鈕不直接提交,改用 AJAX 整體提交,伺服器端統一驗證回傳 JSON 錯誤訊息,前端顯示。

伺服器端二次驗證(必要)

protected void btnSubmit_Click(object sender, EventArgs e)
{
    // 1. 檢查 ASP.NET 驗證
    if (!Page.IsValid) return; // 已由驗證控制項攔截,但雙重保險
    
    // 2. 伺服器端重做關鍵業務驗證(繞過前端攔截)
    if (txtPassword.Text.Length < 8) { ShowError("密碼過短"); return; }
    if (txtPassword.Text != txtConfirm.Text) { ShowError("密碼不符"); return; }
    if (UserService.Exists(txtAccount.Text)) { ShowError("帳號已存在"); return; }
    
    // 3. 業務邏輯...
    UserService.Register(...);
    Response.Redirect("Success.aspx");
}

驗證群組應用:單頁多表單

<!-- 登入區塊 -->
<asp:TextBox ID="txtLoginId" runat="server" />
<asp:RequiredFieldValidator ControlToValidate="txtLoginId" ValidationGroup="Login" ... />
<asp:Button ID="btnLogin" runat="server" ValidationGroup="Login" OnClientClick="return Page_ClientValidate('Login');" />

<!-- 註冊區塊 -->
<asp:TextBox ID="txtRegId" runat="server" />
<asp:RequiredFieldValidator ControlToValidate="txtRegId" ValidationGroup="Register" ... />
<asp:Button ID="btnRegister" runat="server" ValidationGroup="Register" OnClientClick="return ValidateAll();" />

常見錯誤與解決

錯誤原因修正
自訂驗證通過但 ASP.NET 驗證失敗仍提交OnClientClick 未回傳 Page_ClientValidate 結果OnClientClick="return Page_ClientValidate('Group') && CustomValidate();"
UpdatePanel 部分回發驗證失效驗證腳本未重新註冊用 ScriptManager.RegisterStartupScript 重新綁定,或改用 CustomValidator ClientValidationFunction
CustomValidator 客戶端函數不觸發未設定 ClientValidationFunction / ValidateEmptyText="true"加上屬性,函數簽名 function(sender, args) { args.IsValid = ...; }

現代化建議

  • 前端驗證:使用 Parsley.js / Yup + Formik / Veelidate 等成熟庫,聲明式規則、國際化、非同步支援完善。
  • 後端驗證:FluentValidation / DataAnnotations + 自動模型狀態檢查。
  • 前後端分離:API 回傳 400 + 結構化錯誤 {fieldErrors: [{field:"email", message:"..."}]},前端統一顯示。

結語

ASP.NET 驗證控制項與自訂 JS 整合關鍵在於:**OnClientClick="return Page_ClientValidate('Group') && CustomValidate();"**。永遠記住「前端攔截優化體驗,後端驗證保障安全」,兩者缺一不可。現代專案建議將驗證邏輯前移至前端框架與後端 FluentValidation,淘汰 WebForm 驗證控制項。

copyright © 萬盛學電腦網 all rights reserved