ASP.NET DropDownList 數據綁定後設置選中項兩種方法

前言

DropDownList 綁定數據源後，常需根據業務邏輯 (如編輯時回顯、默認選項) 設置選中項。本文對比 FindByValue 與遍歷匹配兩種方法，分析性能差異、適用場景，提供擴展方法封裝建議。

方法一：FindByValue (推薦：簡潔、O(1) 索引查找)

// 綁定
ddl.DataSource = GetCategories();
ddl.DataTextField = "Name";
ddl.DataValueField = "Id";
ddl.DataBind();

// 設置選中項
string targetValue = GetSelectedCategoryId(); // 來自 QueryString/Session/DB
ListItem item = ddl.Items.FindByValue(targetValue);
if (item != null)
{
    ddl.SelectedIndex = ddl.Items.IndexOf(item); // 或 item.Selected = true
}
else
{
    // 未找到：可選插入提示項或保持默認
    ddl.Items.Insert(0, new ListItem("-- 請選擇 --", ""));
}

原理：`ListItemCollection` 內部維护 `Hashtable` 索引 Value→Index，`FindByValue` 為哈希查找，極快。

方法二：遍歷匹配 (兼容舊版/特殊邏輯)

string targetValue = "5";
for (int i = 0; i < ddl.Items.Count; i++)
{
    if (ddl.Items[i].Value == targetValue)
    {
        ddl.SelectedIndex = i;
        break;
    }
}
// 或 do-while 微優化
int i = 0;
do 
{
    if (ddl.Items[i].Value == targetValue) { ddl.SelectedIndex = i; break; }
} while (++i < ddl.Items.Count);

適用場景：

• 需按 Text 匹配 (Value 重複/無 Value)
• 需 模糊/多條件匹配 (如 Value 包含前綴)
• 極老版本 .NET 1.x `FindByValue` 不存在

性能對比 (10萬項測試)

最佳實踐：擴展方法封裝

public static class DropDownListExtensions
{
    /// 
按 Value 設置選中項，不存在則插入提示項
    public static void SelectByValue(this DropDownList ddl, string value, string defaultText = "-- 請選擇 --")
    {
        ddl.ClearSelection();
        var item = ddl.Items.FindByValue(value);
        if (item != null)
        {
            item.Selected = true;
        }
        else if (!string.IsNullOrEmpty(defaultText))
        {
            ddl.Items.Insert(0, new ListItem(defaultText, ""));
        }
    }
    
    /// 
按 Text 設置選中項 (模糊匹配)
    public static void SelectByText(this DropDownList ddl, string text, bool exactMatch = true)
    {
        ddl.ClearSelection();
        var item = exactMatch 
            ? ddl.Items.FindByText(text)
            : ddl.Items.Cast().FirstOrDefault(i => i.Text.Contains(text));
        if (item != null) item.Selected = true;
    }
    
    /// 
安全獲取選中值，未選中返回 defaultValue
    public static string GetSelectedValue(this DropDownList ddl, string defaultValue = "")
    {
        return ddl.SelectedItem?.Value ?? defaultValue;
    }
}

使用示例

// 編輯頁面加載
protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        BindDropDownLists();
        
        if (Request.QueryString["id"] != null) // 編輯模式
        {
            var model = GetModel(int.Parse(Request.QueryString["id"]));
            ddlCategory.SelectByValue(model.CategoryId.ToString());
            ddlStatus.SelectByText(model.Status);
        }
        else // 新增模式
        {
            ddlCategory.SelectByValue("1"); // 默認第一分類
        }
    }
}

常見問題

總結

優先使用 FindByValue + 擴展方法 `SelectByValue`，代碼簡潔、性能最優、語義清晰。遍歷匹配僅作為特殊業務邏輯的補充。統一封裝擴展方法，消除項目中重複的綁定後選中代碼。