使用者連點按鈕導致重複寫入資料庫是經典問題。本文提供「客戶端立即禁用 + 伺服器端冪等檢查」雙重防線,並針對 UseSubmitBehavior、GetPostBackEventReference、UpdatePanel 等情境給出最佳實踐。
<asp:Button ID="BtnSubmit" runat="server" Text="送出"
OnClientClick="this.disabled = true; this.value = '處理中...'; "
UseSubmitBehavior="False"
OnClick="BtnSubmit_Click" />
UseSubmitBehavior="False":ASP.NET 會產生 __doPostBack 腳本而非瀏覽器原生 submit,確保 this.disabled=true 執行後仍能正確回發。<script type="text/javascript">
window.onload = function () {
var btn = document.getElementById('<%= BtnSubmit.ClientID %>');
if (btn) btn.disabled = false;
};
</script>
或在 Page_Load 註冊啟用腳本:
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack)
{
string script = $"document.getElementById('{BtnSubmit.ClientID}').disabled = false;";
ScriptManager.RegisterStartupScript(this, GetType(), "enableBtn", script, true);
}
}
protected void Page_Load(object sender, EventArgs e)
{
// 為每個需防重複的按鈕註冊「先回發再禁用」腳本
RegisterPostBackThenDisable(BtnSave);
RegisterPostBackThenDisable(BtnDelete);
RegisterPostBackThenDisable(BtnExport);
}
private void RegisterPostBackThenDisable(Button btn)
{
// GetPostBackEventReference 產生 __doPostBack('BtnSave','') 腳本
string postBackScript = ClientScript.GetPostBackEventReference(btn, string.Empty);
// 組合:先觸發回發,再禁用按鈕
string combined = $"{postBackScript}; this.disabled = true; this.value = '處理中...';";
btn.Attributes["onclick"] = combined;
}
原理:GetPostBackEventReference 產生的腳本會正確觸發伺服器端 Click 事件,接著瀏覽器執行 this.disabled=true,避免使用者在回發完成前連點。
若按鈕在 UpdatePanel 內,非同步回發結束後按鈕仍處於 disabled 狀態,需在 PageRequestManager 的 endRequest 重新啟用:
<script type="text/javascript">
var prm = Sys.WebForms.PageRequestManager.getInstance();
prm.add_endRequest(function () {
// 依實際按鈕 ID 或 CSS 類別啟用
$get('<%= BtnSubmit.ClientID %>').disabled = false;
});
</script>
客戶端禁用可被繞過 (關閉 JS、攔截器),必須在伺服器端實作冪等鍵:
protected void BtnSubmit_Click(object sender, EventArgs e)
{
// 1. 取得/驗證 Token (存放於 Session 或資料庫)
string token = Request.Form["__ANTI_FORGERY_TOKEN"]; // 隱藏欄位
if (string.IsNullOrEmpty(token) || token != Session["LastSubmitToken"]?.ToString())
{
// 重複提交或 Token 失效:直接返回或顯示友善訊息
ShowMessage("請勿重複送出");
return;
}
// 2. 業務邏輯 (資料庫寫入)
SaveData();
// 3. 更新 Token (單次使用)
Session["LastSubmitToken"] = Guid.NewGuid().ToString();
// 同步更新頁面隱藏欄位 (若無 UpdatePanel 需重新整理頁面)
}
搭配頁面產生新 Token:
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack)
{
Session["LastSubmitToken"] = Guid.NewGuid().ToString();
}
// 將 Token 輸出到隱藏欄位
litToken.Text = $"<input type='hidden' name='__ANTI_FORGERY_TOKEN' value='{Session["LastSubmitToken"]}' />";
}
| 值 | 行為 | 適用情境 |
|---|---|---|
True (預設) | 瀏覽器原生 <input type="submit">,表單由瀏覽器提交 | 純 HTML 表單、不需客戶端攔截 |
False | ASP.NET 產生 __doPostBack 腳本,支援客戶端 onclick 先執行再回發 | 需在回發前執行 JS (驗證、禁用、Loading) |
UseSubmitBehavior="False" + OnClientClick 禁用。