萬盛學電腦網

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

ASP.NET 防止按鈕重複提交:客戶端禁用 + 伺服器端二次驗證完整方案

前言

使用者連點按鈕導致重複寫入資料庫是經典問題。本文提供「客戶端立即禁用 + 伺服器端冪等檢查」雙重防線,並針對 UseSubmitBehavior、GetPostBackEventReference、UpdatePanel 等情境給出最佳實踐。

一、最簡單:OnClientClick 禁用 + UseSubmitBehavior=false

<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 部分更新情境

若按鈕在 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>

五、伺服器端二次防禦:冪等 Token (推薦生產環境)

客戶端禁用可被繞過 (關閉 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"]}' />";
}

六、UseSubmitBehavior 屬性深度解析

值行為適用情境
True (預設)瀏覽器原生 <input type="submit">,表單由瀏覽器提交純 HTML 表單、不需客戶端攔截
FalseASP.NET 產生 __doPostBack 腳本,支援客戶端 onclick 先執行再回發需在回發前執行 JS (驗證、禁用、Loading)

七、總結清單

  1. 所有「寫入/刪除/付款」按鈕:UseSubmitBehavior="False" + OnClientClick 禁用。
  2. 頁面載入/非同步回發結束:恢復按鈕可用狀態。
  3. 關鍵業務:實作伺服器端冪等 Token (Session/DB/Redis)。
  4. 記錄操作日誌:包含使用者、時間、Token、IP,利事後稽核。
copyright © 萬盛學電腦網 all rights reserved