完美解決 Enum 繫結到 ASP.NET 資料控件：DropDownListField 與 EnumDescriptionAttribute 實戰

痛點：Enum 繁瑣的繫結過程

傳統做法：在 `ItemTemplate` 放 `DropDownList`，`RowDataBound` 手動填項、設定 `SelectedValue`、取值時再解析。程式碼分散、難維護、重用性低。

NBear 解決方案：兩大核心組件

1. DropDownListField：繼承 `DataControlField`，可直接用於 `GridView`、`DetailsView` 的 ``/`` 中，聲明式繫結 Enum 欄位。
2. EnumDescriptionAttribute：標註 Enum 成員的顯示描述，支援多語系、Flags 屬性 (位元組合)。

使用範例：GridView 声明式繫結

<%@ Register TagPrefix="nb" Namespace="NBear.Web.Data" Assembly="NBear.Web.Data" %>
<asp:GridView ID="TestGrid" runat="server" DataSourceID="TestDS" AutoGenerateColumns="False">
  <Columns>
    <asp:BoundField DataField="SimpleId" HeaderText="ID" />
    <asp:BoundField DataField="SimpleName" HeaderText="名稱" />
    <nb:DropDownListField DataField="Status" HeaderText="狀態" SortExpression="Status"
        EnumType="EntityDesigns.SimpleStatus" />
  </Columns>
</asp:GridView>

Enum 定義與描述標註

public enum SimpleStatus
{
    [NBear.Common.EnumDescription(DefaultDescription = "待處理")]
    Pending = 1,

    [NBear.Common.EnumDescription(DefaultDescription = "處理中")]
    Processing = 2,

    [NBear.Common.EnumDescription(DefaultDescription = "已完成")]
    Completed = 3
}

// 位元組合 Enum (Flags)
[Flags]
public enum Permissions
{
    [EnumDescription(DefaultDescription = "讀取")]
    Read = 1,

    [EnumDescription(DefaultDescription = "寫入")]
    Write = 2,

    [EnumDescription(DefaultDescription = "執行")]
    Execute = 4,

    [EnumDescription(DefaultDescription = "管理")]
    Admin = Read | Write | Execute
}

核心優勢

進階功能

• 第三方 Enum 擴充**：無法修改原始 Enum 時，可透過設定檔或註冊機制外掛 Description。
• 自定義資料來源**：繼承 `DropDownListField` 覆寫 `GetDataSource` 實現動態過濾 (如依角色顯示不同狀態)。
• DetailsView/FormView 同樣適用**：插入/編輯模式自動呈現下拉選單，預設值正確綁定。

取得組件

NBear 為開源 ORM 框架，`NBear.Web.Data` 組件可從 NuGet 或官方網站取得。若專案未引入 NBear，亦可參考其原始碼自行實作類似 `DataControlField`。

總結

`DropDownListField` + `EnumDescriptionAttribute` 將 Enum 繫結從「程式碼堆疊」提升為「聲明式配置」，徹底解決顯示描述、編輯雙向繫結、多語系、Flags 多選等痛點，是 ASP.NET Web Forms 處理 Enum 欄位的最佳實踐。