ASP.NET ListView 控制項隱藏按鈕的兩種解決方案與原理分析

前言

在 ASP.NET ListView 控制項的 ItemTemplate 中動態隱藏按鈕（如編輯、刪除）是常見需求。然而直接使用 FindControl 常導致「物件參考未設定為物件實例」錯誤。本文深入分析根因，提供兩種實務解決方案。

一、問題重現與根因分析

錯誤程式碼：

protected void ListView1_ItemCreated(object sender, ListViewItemEventArgs e)
{
    Button DeleteButton = (Button)ListView1.FindControl("DeleteButton");
    Button EditButton = (Button)ListView1.FindControl("EditButton");
    
    string username = Session["username"].ToString();
    if (username != "admin")
    {
        EditButton.Visible = false;  // NullReferenceException
        DeleteButton.Visible = false;
    }
}

根因：INamingContainer 與控制項 ID 重命名

ListView 實作 INamingContainer 介面，會為每個資料列建立獨立的命名容器。執行時期，DeleteButton 實際 ID 會變為：

ListView1_ctrl0_DeleteButton
ListView1_ctrl1_DeleteButton
...

直接對 ListView 呼叫 FindControl 找不到具體資料列內的控制項，回傳 null，導致後續存取 Visible 屬性拋出例外。

二、方案一：在正確容器中尋找控制項 + 防禦性檢查

修正後程式碼：

protected void ListView1_ItemCreated(object sender, ListViewItemEventArgs e)
{
    // 關鍵：使用 e.Item (當前資料列容器) 而非 ListView1
    Button DeleteButton = (Button)e.Item.FindControl("DeleteButton");
    Button EditButton = (Button)e.Item.FindControl("EditButton");
    
    string username = Session["username"]?.ToString() ?? "";
    
    // 防禦性檢查：確保控制項存在才操作
    if (username != "admin" && DeleteButton != null && EditButton != null)
    {
        EditButton.Visible = false;
        DeleteButton.Visible = false;
    }
}

關鍵修正點：

• 使用 e.Item.FindControl：ListViewItemEventArgs.Item 代表當前資料列的命名容器
• 加入 null 檢查：避免模板切換（編輯/插入模式）時找不到按鈕導致例外
• Session 安全存取：使用 ?. 和 ?? 避免 Session 為 null 時拋出例外

三、方案二：宣告式繫結 Visible 屬性（推薦）

ASPX 標記：

<asp:Button ID="DeleteButton" runat="server" 
    CommandName="Delete" Text="刪除"
    Visible='<%# Session["username"] != null && Session["username"].ToString() == "admin" %>' />

<asp:Button ID="EditButton" runat="server" 
    CommandName="Edit" Text="編輯"
    Visible='<%# Session["username"] != null && Session["username"].ToString() == "admin" %>' />

優點分析：

• 零後端程式碼：邏輯集中在標記，符合關注點分離
• 自動處理資料繫結週期：每個資料列繫結時自動評估運算式
• 效能較佳：避免遍歷控制項樹的 FindControl 開銷
• 支援所有模板模式：ItemTemplate、EditItemTemplate、InsertItemTemplate 皆適用

注意事項：

• 頁面需呼叫 DataBind() 或控制項需在繫結容器中
• 運算式中存取 Session 需做 null 檢查
• 複雜邏輯建議移至後端屬性/方法，標記中呼叫 <%# CanEdit() %>

四、進階：搭配角色權限系統

<!-- 後端屬性 -->
public bool CanDelete 
{ 
    get { return User.IsInRole("Admin") || User.Identity.Name == "admin"; } 
}

<-- 標記 -->
<asp:Button ID="DeleteButton" runat="server" 
    Visible='<%# Container.DataItem != null && CanDelete %>' />

五、方案比較總結

結語

ListView 隱藏按鈕的核心在於理解 INamingContainer 機制與 資料繫結生命週期。方案二（宣告式繫結）因簡潔、高效、易維護，應作為首選；方案一適用於需在伺服端執行複雜邏輯判斷的場景。實務建議：優先使用宣告式 Visible 繫結，複雜情況再考慮後端控制。