萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 動態生成 ASP.NET WebForms 伺服器控制項完整實戰:RadioButtonList 聯動新增 TextBox/Validator

核心挑戰

ASP.NET WebForms 伺服器控制項 (runat="server") 需在**伺服端渲染**產生正確的 name/id (如 ctl00$ContentPlaceHolder1$txtBox) 並參與 ViewState/Postback 生命週期。**瀏覽器端 jQuery 無法直接產生可被伺服端識別的伺服器控制項**。

可行策略對比

策略原理優點缺點適用場景
1. 伺服端動態建立 (推薦)後端 Page_Load/事件中 Controls.Add()完整生命週期、ViewState、驗證、Postback 正常需 Postback/UpdatePanel、前後端分離度低傳統 WebForms 專案、複雜驗證邏輯
2. UpdatePanel 部分更新AJAX 觸發後端動態建立,局部重渲染無整頁重整、保留伺服端模型ViewState 傳輸大、效能較差、難除錯既有 UpdatePanel 架構專案
3. 客戶端渲染 HTML + 隱藏欄位收集jQuery 建立純 HTML input,隱藏欄位存 JSON 提交前端體驗佳、無 Postback、可用前端框架後端需手動解析 Request.Form、失去驗證控制項漸進式現代化、簡單表單
4. Web Method / PageMethod + AJAX靜態方法接收 JSON,前端渲染純 AJAX、前後端分離無 ViewState、無控制項事件、需自行處理狀態新功能模組、API 化

方案一:伺服端動態建立 (標準 WebForms 做法)

前端 (.aspx)

<asp:RadioButtonList ID="rblPayAccount" runat="server" RepeatLayout="Flow" AutoPostBack="true" 
    OnSelectedIndexChanged="rblPayAccount_SelectedIndexChanged">
    <asp:ListItem Text="銀行轉帳" Value="Bank" />
    <asp:ListItem Text="現金" Value="Cash" />
    <asp:ListItem Text="其他帳戶" Value="Other" />
</asp:RadioButtonList>

<asp:PlaceHolder ID="phOtherAccount" runat="server" Visible="false">
    <div class="form-group">
        <label>其他帳戶名稱</label>
        <asp:TextBox ID="txtOtherAccount" runat="server" />
        <asp:RequiredFieldValidator ID="rfvOther" runat="server" ControlToValidate="txtOtherAccount" 
            ErrorMessage="請輸入帳戶名稱" Display="Dynamic" CssClass="text-danger" />
    </div>
</asp:PlaceHolder>

後端 (.aspx.cs)

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        // 初始化綁定資料...
    }
    // 動態控制項必須在每次 Postback 重建 (在 PreInit 或 Load 前)
    // 但用 PlaceHolder.Visible 控制較簡單,由框架自動處理重建
}

protected void rblPayAccount_SelectedIndexChanged(object sender, EventArgs e)
{
    // 顯示/隱藏「其他帳戶」輸入區
    phOtherAccount.Visible = (rblPayAccount.SelectedValue == "Other");
    
    // 若隱藏,清空驗證
    if (!phOtherAccount.Visible) {
        txtOtherAccount.Text = "";
        // 驗證器會自動不驗證隱藏控制項
    }
}

protected void btnSubmit_Click(object sender, EventArgs e)
{
    if (Page.IsValid) {
        string account = (rblPayAccount.SelectedValue == "Other") 
            ? txtOtherAccount.Text.Trim() 
            : rblPayAccount.SelectedItem.Text;
        // 儲存邏輯...
    }
}

方案二:jQuery 前端動態顯隱 + 隱藏欄位提交 (無 Postback、輕量)

**前提**:不需伺服端驗證控制項,後端自行解析 Request.Form。

前端

<asp:RadioButtonList ID="rblPayAccount" runat="server" RepeatLayout="Flow" ClientIDMode="Static">
    <asp:ListItem Value="Bank">銀行轉帳</asp:ListItem>
    <asp:ListItem Value="Cash">現金</asp:ListItem>
    <asp:ListItem Value="Other">其他帳戶</asp:ListItem>
</asp:RadioButtonList>

<div id="divOtherAccount" style="display:none;">
    <label>其他帳戶名稱</label>
    <input type="text" id="txtOtherAccount" name="txtOtherAccount" class="form-control" />
    <span class="text-danger" id="errOther" style="display:none;">請輸入帳戶名稱</span>
</div>

<!-- 隱藏欄位統一提交給後端 -->
<input type="hidden" name="payAccountValue" id="hdnPayAccount" />

<script>
$(function() {
    var $rbl = $('#rblPayAccount input[type="radio"]');
    var $divOther = $('#divOtherAccount');
    var $txtOther = $('#txtOtherAccount');
    var $errOther = $('#errOther');
    var $hdn = $('#hdnPayAccount');

    $rbl.on('change', function() {
        var val = $(this).val();
        if (val === 'Other') {
            $divOther.slideDown(200);
            $txtOther.prop('required', true).focus();
        } else {
            $divOther.slideUp(200);
            $txtOther.prop('required', false).val('');
            $errOther.hide();
        }
        // 同步隱藏欄位 (供非 AJAX 提交)
        $hdn.val(val);
    });

    // 表單提交前驗證
    $('form').on('submit', function() {
        if ($('#rblPayAccount input:checked').val() === 'Other' && !$txtOther.val().trim()) {
            $errOther.show();
            $txtOther.focus();
            return false; // 阻止提交
        }
        $errOther.hide();
        return true;
    });
});
</script>

後端接收 (.aspx.cs)

protected void btnSubmit_Click(object sender, EventArgs e)
{
    string payType = Request.Form["rblPayAccount$ctl00"]; // RadioButtonList 實際 name
    // 或用隱藏欄位
    payType = Request.Form["payAccountValue"]; 
    
    string accountName = "";
    if (payType == "Other") {
        accountName = Request.Form["txtOtherAccount"]?.Trim() ?? "";
        if (string.IsNullOrEmpty(accountName)) {
            // 顯示錯誤 (需配合前端或回傳 JSON)
            return;
        }
    } else {
        // 從 ListItem 取得文字
        var item = rblPayAccount.Items.FindByValue(payType);
        accountName = item?.Text ?? payType;
    }
    
    // 儲存...
}

方案三:純前端渲染 + Web API (現代化、前後端分離)

<!-- 純 HTML,無 runat="server" -->

關鍵技術細節總結

  1. ClientIDMode="Static":讓伺服器控制項輸出固定 ID,方便 jQuery 選取 ($('#rblPayAccount'))。
  2. AutoPostBack="true":RadioButtonList 選擇變更觸發 Postback,後端可動態控制 PlaceHolder.Visible。
  3. 動態控制項重建:若用 Controls.Add() 動態新增控制項,**必須在 Page_Init 或 Page_Load (ViewState 載入前) 每次重建**,且 ID 必須一致,否則事件不觸發、ViewState 丟失。
  4. 驗證控制項:RequiredFieldValidator 等只能驗證 runat="server" 的控制項。純 HTML input 需前端 JS 驗證或後端手動檢查。
  5. UpdatePanel 陷阱:動態控制項在 UpdatePanel 內需觸發 UpdatePanel.Update(),且完整 ViewState 來回傳輸,效能差。

遷移建議

  1. 新功能:直接寫 Web API + 前端框架 (Vue/React/Blazor),不使用 WebForms 控制項。
  2. 既有功能:維持 PlaceHolder.Visible + AutoPostBack 模式,穩定可維護。
  3. 逐步剝離:將頁面拆分為 UserControl,再逐個改寫為 API + 前端元件。
  4. 共存期:ScriptManager + PageMethods / WebMethod 供 AJAX 呼叫,漸進式減少 Postback。

總結

jQuery **無法** 直接產生 ASP.NET 伺服器控制項。正解是:**伺服端動態建立** (標準模式) 或 **前端渲染純 HTML + AJAX 提交** (現代模式)。根據專案現狀與技術債務,選擇適合的策略,避免在前端強行模擬伺服器控制項行為 (ViewState、事件、驗證)。

copyright © 萬盛學電腦網 all rights reserved