萬盛學電腦網

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

ASP.NET GridView 綁定 List 集合完整實作:實體類、管理類、前端綁定與行選取傳值

前言

GridView 強型別綁定 `List` 是面向對象開發的最佳實踐,優於 `DataTable`:型別安全、IntelliSense 支援、業務邏輯封裝。本文提供完整範例:實體類 `PersonModel`、單例管理類 `ChildFrmManager`、GridView 宣告與綁定、行選取事件、JavaScript 參數回傳父頁面 (彈出視窗模式)。

1. 實體類


public class PersonModel
{
    public int PersonIndex { get; set; }      // 序號
    public string PersonID { get; set; }      // 主鍵 (Guid)
    public string PersonName { get; set; }    // 姓名
    public string PersonSex { get; set; }     // 性別
    public int PersonAge { get; set; }        // 年齡
    public bool PersonSelected { get; set; }  // 是否選取 (供前端 CheckBox)
}

2. 資料管理類 (單例模式)


public class ChildFrmManager
{
    private List _personCollect = new List();
    private static ChildFrmManager _instance;
    private static readonly object _lock = new object();

    public List PersonCollect => _personCollect;

    public static ChildFrmManager Instance
    {
        get
        {
            if (_instance == null)
            {
                lock (_lock)
                {
                    if (_instance == null) _instance = new ChildFrmManager();
                }
            }
            return _instance;
        }
    }

    public void InitializeData()
    {
        _personCollect.Clear();
        for (int i = 0; i < 20; i++)
        {
            _personCollect.Add(new PersonModel
            {
                PersonIndex = i + 1,
                PersonID = Guid.NewGuid().ToString(),
                PersonName = $"測試人員 {i + 1}",
                PersonAge = 27 + i,
                PersonSex = (i % 2 == 0) ? "男" : "女",
                PersonSelected = false
            });
        }
    }
    
    // 供外部新增/修改/刪除
    public void Add(PersonModel model) => _personCollect.Add(model);
    public bool Remove(string personId) => _personCollect.RemoveAll(p => p.PersonID == personId) > 0;
}

3. 前端 GridView 宣告 (ChildFrm.aspx)


<%@ Page Language="C#" AutoEventWireup="true" CodeFile="ChildFrm.aspx.cs" Inherits="ChildFrm" %>
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
    <title>人員選取彈出視窗</title>
    <style>
        .gv { width: 100%; border-collapse: collapse; font-family: Microsoft JhengHei; }
        .gv th { background: #343a40; color: white; padding: 8px; text-align: left; }
        .gv td { padding: 8px; border-bottom: 1px solid #dee2e6; }
        .gv tr:hover { background: #f8f9fa; }
        .btn-select { padding: 2px 8px; font-size: 12px; }
    </style>
</head>
<body>
    <form id="form1" runat="server">
        <asp:GridView ID="gvPersons" runat="server" 
            AutoGenerateColumns="False" 
            DataKeyNames="PersonID" 
            CssClass="gv"
            OnSelectedIndexChanged="gvPersons_SelectedIndexChanged"
            OnRowDataBound="gvPersons_RowDataBound">
            <Columns>
                <asp:CommandField ShowSelectButton="True" SelectText="選取" ButtonType="Button" 
                    ControlStyle-CssClass="btn-select" HeaderText="操作" />
                <asp:BoundField DataField="PersonIndex" HeaderText="序號" ItemStyle-Width="50px" />
                <asp:BoundField DataField="PersonID" HeaderText="ID" Visible="false" /> <!-- 隱藏但可透過 DataKeys 取得 -->
                <asp:BoundField DataField="PersonName" HeaderText="姓名" />
                <asp:BoundField DataField="PersonSex" HeaderText="性別" ItemStyle-Width="60px" />
                <asp:BoundField DataField="PersonAge" HeaderText="年齡" ItemStyle-Width="60px" />
            </Columns>
            <EmptyDataTemplate>查無人員資料</EmptyDataTemplate>
        </asp:GridView>
    </form>
    
    <script type="text/javascript">
        // 選取行後回傳值給父視窗 (假設由 window.open 開啟)
        function returnToParent(personId, personName) {
            if (window.opener && !window.opener.closed) {
                // 呼叫父頁面函式或設定控制項值
                window.opener.setSelectedPerson(personId, personName);
            }
            window.close();
        }
    </script>
</body>
</html>

4. 後台程式碼 (ChildFrm.aspx.cs)


public partial class ChildFrm : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // 初始化資料 (單例模式,首次載入)
            ChildFrmManager.Instance.InitializeData();
            BindGrid();
        }
    }

    private void BindGrid()
    {
        gvPersons.DataSource = ChildFrmManager.Instance.PersonCollect;
        gvPersons.DataBind();
    }

    // 行選取事件 (CommandField ShowSelectButton 觸發)
    protected void gvPersons_SelectedIndexChanged(object sender, EventArgs e)
    {
        string personId = gvPersons.SelectedDataKey.Value.ToString();
        // 取得該行資料 (透過 DataSource 找回)
        var person = ChildFrmManager.Instance.PersonCollect.FirstOrDefault(p => p.PersonID == personId);
        if (person != null)
        {
            // 註冊啟動腳本,呼叫前端函式回傳值給父視窗並關閉
            string script = $"returnToParent('{person.PersonID}', '{person.PersonName.Replace("'", "\\'")}');";
            ClientScript.RegisterStartupScript(this.GetType(), "returnValue", script, true);
        }
    }

    // 可選:RowDataBound 動態調整樣式
    protected void gvPersons_RowDataBound(object sender, GridViewRowEventArgs e)
    {
        if (e.Row.RowType == DataControlRowType.DataRow)
        {
            var person = (PersonModel)e.Row.DataItem;
            if (person.PersonAge > 50) e.Row.CssClass = "table-warning"; // 高齡標示
        }
    }
}

5. 父頁面呼叫與接收


<!-- ParentPage.aspx -->
<asp:TextBox ID="txtSelectedPerson" runat="server" ReadOnly="true" />
<asp:Button ID="btnOpenSelector" runat="server" Text="選擇人員" 
    OnClientClick="window.open('ChildFrm.aspx', 'PersonSelector', 'width=800,height=600'); return false;" />

<script>
function setSelectedPerson(id, name) {
    document.getElementById('<%= txtSelectedPerson.ClientID %>').value = name;
    // 若需存 ID 可用 HiddenField
    document.getElementById('<%= hfPersonId.ClientID %>').value = id;
}
</script>

進階:分頁、排序、搜尋




protected void gv_PageIndexChanging(object sender, GridViewPageEventArgs e)
{
    gvPersons.PageIndex = e.NewPageIndex;
    BindGrid();
}

protected void gv_Sorting(object sender, GridViewSortEventArgs e)
{
    var list = ChildFrmManager.Instance.PersonCollect;
    // 簡易排序邏輯 (實務建議用 LINQ Dynamic 或表達式樹)
    string sortExpr = e.SortExpression;
    SortDirection dir = e.SortDirection;
    // ... 排序邏輯 ...
    BindGrid();
}

避免常見坑點

ViewState 過大
GridView `EnableViewState="false"`,每次 `Page_Load` 重新綁定 (如範例)。大量資料必開啟分頁。
DataKeyNames 必須設定主鍵
否則 `SelectedDataKey` 為 null,無法取得 ID。
單例模式在 Web 環境的生命週期
靜態單例生命週期 = 應用程式域存活。多用戶共享同一份資料!**實務上應改用 Session、資料庫或每請求新建**。範例為教學示範。
JavaScript 注入風險
回傳字串給 JS 時必須跳脫單引號 `Replace("'", "\\'")`,防止 XSS。

總結:GridView 綁定 `List` 步驟:1. 定義實體類 2. 準備資料來源 (List) 3. 設定 `DataKeyNames` 4. `DataSource = list; DataBind()` 5. 使用 `SelectedDataKey` 取得主鍵 6. 前端 JS 回傳值。單例管理類僅供示範,實務請用 Session/資料庫/服務層管理資料狀態。掌握此模式,可構建型別安全、可維護的資料呈現介面。

copyright © 萬盛學電腦網 all rights reserved