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>
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 = ...; } |
{fieldErrors: [{field:"email", message:"..."}]},前端統一顯示。ASP.NET 驗證控制項與自訂 JS 整合關鍵在於:**OnClientClick="return Page_ClientValidate('Group') && CustomValidate();"**。永遠記住「前端攔截優化體驗,後端驗證保障安全」,兩者缺一不可。現代專案建議將驗證邏輯前移至前端框架與後端 FluentValidation,淘汰 WebForm 驗證控制項。