C# DataGrid/GridView 動態產生資料行：實作 ITemplate 與 OnDataBinding

當 GridView 欄位數量、顯示/隱藏需在執行期依設定決定時，無法使用靜態 <asp:BoundField>。解決方案是建立實作 ITemplate 的動態欄位類別，在 InstantiateIn 中掛載 DataBinding 事件，於 OnDataBinding 中依資料列內容動態決定輸出（如勾選符號、格式化文字、控制項顯示/隱藏）。

動態欄位類別實作

using System.Web.UI;
using System.Web.UI.WebControls;

public class DynamicColumn : ITemplate
{
    private readonly string _dataField;   // 資料來源欄位名
    private readonly int _matchValue;     // 比對值

    public DynamicColumn(string dataField, int matchValue)
    {
        _dataField = dataField;
        _matchValue = matchValue;
    }

    public void InstantiateIn(Control container)
    {
        var lbl = new Label();
        lbl.DataBinding += OnDataBinding; // 關鍵：掛載 DataBinding 事件
        container.Controls.Add(lbl);
    }

    private void OnDataBinding(object sender, EventArgs e)
    {
        var lbl = (Label)sender;
        var row = (DataGridItem)lbl.NamingContainer; // GridView 用 GridViewRow
        var dataItem = (DataRowView)row.DataItem;

        int cellValue = int.Parse(dataItem[_dataField].ToString());
        lbl.Text = (cellValue == _matchValue) ? "✓" : "";
    }
}

使用方式

// 程式碼後置 Page_Load 或 GridView PreRender
if (!IsPostBack)
{
    // 假設從設定檔讀取要顯示的欄位
    var columnsConfig = new[] { new { Field = "Status", Match = 1 }, new { Field = "IsActive", Match = 1 } };

    foreach (var cfg in columnsConfig)
    {
        var templateField = new TemplateField
        {
            HeaderText = cfg.Field,
            ItemTemplate = new DynamicColumn(cfg.Field, cfg.Match)
        };
        GridView1.Columns.Add(templateField);
    }

    GridView1.DataSource = GetData(); // DataTable/List
    GridView1.DataBind();
}

關鍵點解析

進階擴充

• 多種控制項：InstantiateIn 可 new CheckBox、DropDownList、Image、HyperLink 等，視需求輸出。
• 條件式顯示/隱藏：OnDataBinding 中設定 Control.Visible = false。
• 雙向繫結：EditItemTemplate 實作 IEditableTemplate 或手動處理 RowUpdating 取值。
• 效能：大量資料時，動態建立控制項開銷較大；可考慮 RowDataBound 直接操作 e.Row.Cells[i].Controls。

適用場景

• 欄位由資料庫/設定檔動態決定的報表。
• 同一 GridView 需支援多種檢視模式（簡易/詳細/管理員）。
• 欄位內容需複雜邏輯判斷（如依角色顯示不同圖示/連結）。

掌握 ITemplate + DataBinding 模式，讓 GridView 欄位真正實現「執行期完全可配置」。