ASP.NET MVC DropDownListFor 設定預設選中項完整指南：三種實戰模式

核心機制

DropDownListFor 依賴 List<SelectListItem> 做為資料來源，每個 SelectListItem 擁有 Text（顯示文字）、Value（提交值）、Selected（是否預設選中）三屬性。**關鍵在於：在 Controller 端根據 Model 資料，將對應項目的 Selected = true，再透過 ViewBag/ViewData/Model 傳遞至 View。**

模式一：Controller 端遍歷設定（最通用、零侵入 Model）

適用場景

• 下拉選單資料來源固定（如字典表、枚舉）。
• 不想污染 Domain Model / ViewModel。

Controller 實作

public ActionResult Edit(int id)
{
    // 1. 取得領域模型（含需綁定的屬性值）
    var domain = _service.GetById(id); // 假設 domain.CategoryId = 3

    // 2. 取得下拉選單原始資料
    var items = _dictService.GetCategoryItems(); // 回傳 List

    // 3. 遍歷比對，設定 Selected
    foreach (var item in items)
    {
        item.Selected = item.Value == domain.CategoryId.ToString();
    }

    // 4. 傳遞至 View
    ViewBag.Categories = items;
    return View(domain);
}

View 實作

@model DomainModel
@Html.DropDownListFor(m => m.CategoryId, (List)ViewBag.Categories, "== 請選擇 ==")

模式二：ViewModel 內建 IsSelected（乾淨、強型別、利於測試）

適用場景

• 下拉選單資料動態、需攜帶額外中繼資料（如停用狀態、圖示）。
• 追求 ViewModel 自包含，Controller 不處理 UI 邏輯。

ViewModel 定義

public class DepartmentOption
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsSelected { get; set; } // UI 狀態
    public bool IsDisabled { get; set; } // 擴充：是否停用
}

Controller 組裝

public ActionResult Index()
{
    var currentDeptId = GetCurrentUserDeptId(); // 來源：Session、Claim、QueryString...

    var options = _db.Departments
        .Select(d => new DepartmentOption
        {
            Id = d.Id,
            Name = d.Name,
            IsSelected = d.Id == currentDeptId,
            IsDisabled = d.IsArchived
        })
        .ToList();

    // 轉為 SelectListItem（可寫成擴充方法）
    var items = options.Select(o => new SelectListItem
    {
        Text = o.Name,
        Value = o.Id.ToString(),
        Selected = o.IsSelected,
        Disabled = o.IsDisabled
    }).ToList();

    ViewBag.Departments = items;
    return View();
}

模式三：SelectList 建構子直接指定 selectedValue（最簡潔）

適用場景

• 資料來源為簡單實體集合，無需額外 UI 邏輯。
• 偏好一行程式碼完成綁定。

Controller

public ActionResult Index(string selectedId) // 來自 QueryString 或 PostBack
{
    var projects = _repo.GetAllProjects(); // List { Id, Name }

    // SelectList 建構子：(items, dataValueField, dataTextField, selectedValue)
    ViewBag.Projects = new SelectList(projects, "Id", "Name", selectedId);

    return View();
}

View

@using (Html.BeginForm())
{
    @Html.DropDownList("ProjectId", ViewBag.Projects as SelectList, "== 請選擇 ==")
    
}

進階技巧與避坑指南

1. 多選下拉框

// Model
public int[] SelectedCategoryIds { get; set; }

// View
@Html.ListBoxFor(m => m.SelectedCategoryIds, (MultiSelectList)ViewBag.Categories)

// Controller
ViewBag.Categories = new MultiSelectList(items, "Value", "Text", model.SelectedCategoryIds);

2. 選項分組

var groups = items
    .GroupBy(i => i.GroupName)
    .Select(g => new SelectListGroup { Name = g.Key })
    .ToList();

foreach (var item in items)
    item.Group = groups.First(g => g.Name == item.GroupName);

3. 常見錯誤

總結選型建議