ASP.NET DropDownList 控制項資料綁定與取值完整指南

DropDownList 是 ASP.NET WebForms 最常用的下拉選單控制項。本文快速整理資料綁定與取值的標準寫法。

1. 資料綁定

this.DropDownList1.DataSource = CategoryManager.GetCategories();
DropDownList1.DataValueField = "Id";      // 對應 value 屬性（通常為主鍵）
DropDownList1.DataTextField = "Name";     // 對應顯示文字
DropDownList1.DataBind();

關鍵屬性說明

加入預設提示項目（如「請選擇」）

DropDownList1.Items.Insert(0, new ListItem("請選擇", ""));
// 或標記法
<asp:DropDownList ID="DropDownList1" runat="server" AppendDataBoundItems="true">
    <asp:ListItem Text="請選擇" Value="" />
</asp:DropDownList>

2. 取得使用者選取值

// 取得 Value（對應 DataValueField）
int categoryId = int.Parse(this.DropDownList1.SelectedValue);

// 取得 Text（對應 DataTextField）
string categoryName = this.DropDownList1.SelectedItem.Text;

// 取得索引
int index = this.DropDownList1.SelectedIndex; // -1 表示未選取

常用屬性對照

3. 進階技巧

多欄位顯示（Text 組合多個欄位）

資料來源查詢時組合：

SELECT Id, Name + ' (' + Code + ')' AS DisplayText FROM Categories

或綁定後處理：

DropDownList1.DataBound += (s, e) => {
    foreach (ListItem item in DropDownList1.Items)
    {
        // 從 DataItem 取得額外欄位組合 Text
    }
};

啟用/停用特定項目

DropDownList1.Items.FindByValue("3").Enabled = false; // 灰色不可選

自動回傳

DropDownList1.AutoPostBack = true;
DropDownList1.SelectedIndexChanged += DropDownList1_SelectedIndexChanged;

常見錯誤避坑

• Page_Load 重複綁定：必須包在 if (!IsPostBack) 內
• SelectedValue 為空字串轉 int 擲例外：先判斷 string.IsNullOrEmpty(ddl.SelectedValue)
• 資料來源欄位名稱拼寫錯誤：DataValueField/DataTextField 需與資料來源欄位名完全一致（含大小寫）

掌握這些基礎操作，即可輕鬆駕馭 DropDownList 於各種表單與查詢介面中。

1. 上一篇文章： .NET 多執行緒異常處理技巧：從基礎捕獲到全域策略
2. 下一篇文章： ASP.NET GridView 配合 CheckBox 實現全選/取消全選功能

ASP.NET 基礎

ASP.NET MVC EF 延遲載入深度解析：DbQuery、IQueryable 與 SQL 執行時機

Entity Framework 的延遲載入 是把雙面刃：用

ASP.NET Core 中應用 Entity Framework Core Database-First 完整教程

重要提醒 .NET Core 版 EF Core 與傳統 .

ASP.NET 2.0 數據操作系列（六十四）：GridView 批量新增資料實作

前言 延續前兩篇（批次更新、批次刪除），本文實作批次新增介面

ASP.NET AJAX：JavaScript 直接呼叫伺服器端 C# 方法 (WCF/WebService 完整實作)

架構概覽 利用 ASP.NET AJAX 機制，透過 Scr