萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET MVC 從控制器傳遞資料到視圖的完整指南

前言

在 ASP.NET MVC 架構中,控制器負責處理業務邏輯並準備資料,視圖負責呈現。掌握多種傳遞資料的方式,能讓程式碼更乾淨、可維護性更高。本文將介紹 ViewData、ViewBag、TempData、強型別模型、ViewModel 模式等主流做法,並說明適用場景與優缺點。

一、ViewData 與 ViewBag:動態字典與動態物件

ViewData

  • 型別:ViewDataDictionary(字典)
  • 存取:ViewData["Key"] = value / var val = ViewData["Key"]
  • 需型別轉換,鍵名為字串易拼錯
  • 生命週期:僅目前要求(Request)有效

ViewBag

  • 型別:dynamic 包裝 ViewData
  • 存取:ViewBag.Key = value / var val = ViewBag.Key
  • 無需型別轉換,但執行期才發現錯誤
  • 同樣僅目前要求有效

程式碼範例

public ActionResult Index()
{
    ViewData["Title"] = "首頁";
    ViewData["UserCount"] = 123;
    ViewBag.Message = "歡迎使用 MVC";
    ViewBag.IsAdmin = true;
    return View();
}

二、TempData:跨要求暫存資料

  • 基於 Session 實現,預設讀取後即刪除(Keep() 可保留)
  • 適用場景:重導向 後傳遞訊息(如成功/錯誤提示)
  • 型別同 ViewDataDictionary,需轉型
public ActionResult Create(FormCollection form)
{
    // 業務邏輯...
    TempData["SuccessMsg"] = "新增成功!";
    return RedirectToAction("Index"); // 重導向後 Index 仍可讀取
}

public ActionResult Index()
{
    ViewBag.Msg = TempData["SuccessMsg"]; // 讀取並自動移除
    return View();
}

三、強型別模型:最佳實踐

直接傳遞領域模型或實體類別給視圖,視圖宣告 @model Namespace.ModelName,享有 IntelliSense、編譯期檢查、重構支援。

// 控制器
public ActionResult Detail(int id)
{
    var product = _repo.GetById(id);
    return View(product); // 強型別傳遞
}

// 視圖
@model Product

@Model.Name

價格:@Model.Price

四、ViewModel 模式:視圖專用資料容器

當視圖需求與資料庫實體不一致時(如結合多表、只顯示部分欄位、加入 UI 專用屬性),建立專屬 ViewModel 類別,控制器負責映射轉換。

public class ProductDetailViewModel
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    public string CategoryName { get; set; } // 來自關聯表
    public bool CanEdit { get; set; } // UI 權限旗標
}

五、其他進階技巧

  • ViewData.ModelMetadata:在視圖中取得模型中繼資料(顯示名稱、驗證屬性等)。
  • Partial View 傳遞模型:@Html.Partial("_Partial", childModel)。
  • Tuple / ValueTuple:簡單多模型場景可用 @model (Product, Category),但語意不如 ViewModel 清楚。

六、選型建議速查表

方式型別安全壽命建議用途
ViewData否單一 Request少量臨時資料、Layout 共用區塊
ViewBag否單一 Request少量臨時資料、偏好動態語法
TempData否下一個 RequestRedirect 後傳遞一次性訊息
強型別 Model是單一 Request主要業務資料、表單繫結
ViewModel是單一 Request複雜視圖、多來源彙整、UI 專用欄位

結語

實務開發中,以強型別模型或 ViewModel 為主,搭配 TempData 處理重導向訊息,少量共用資料可用 ViewData/ViewBag。避免在視圖中放置複雜邏輯,保持關注點分離。

copyright © 萬盛學電腦網 all rights reserved