萬盛學電腦網

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

ASP.NET MVC 2/3 自訂視圖搜尋路徑:ViewEngine 客製化完整教學

ASP.NET MVC 預設視圖搜尋路徑為 ~/Views/{Controller}/{Action}.cshtml 等。專案需求常需調整結構 (如依區域、模組、主題分類),需自訂 ViewEngine。

核心步驟 (MVC 2 與 MVC 3 通用)

  1. 建立繼承自對應基底類別的自訂 ViewEngine
  2. 覆寫 ViewLocationFormats、MasterLocationFormats、PartialViewLocationFormats 屬性
  3. 在 Global.asax Application_Start 中註冊

MVC 2 (WebForms ViewEngine)

protected void Application_Start() {
    AreaRegistration.RegisterAllAreas();
    ViewEngines.Engines.Clear();
    ViewEngines.Engines.Add(new MvcViewEngine());
    RegisterRoutes(RouteTable.Routes);
}

public class MvcViewEngine : WebFormViewEngine {
    public MvcViewEngine() {
        // Master/Layout 頁面搜尋路徑
        base.MasterLocationFormats = new[] {
            "~/Views/{1}/{0}.master",
            "~/Views/Shared/{0}.master"
        };
        // View 頁面搜尋路徑
        base.ViewLocationFormats = new[] {
            "~/Views/Books/{1}/{0}.aspx",   // 依 Controller 分組
            "~/Views/Books/{1}/{0}.ascx",
            "~/Views/Shared/{0}.ascx",
            "~/Views/{1}/{0}.aspx"
        };
        // Partial View 共用 View 路徑
        base.PartialViewLocationFormats = base.ViewLocationFormats;
    }
}

關鍵差異:繼承 WebFormViewEngine,副檔名為 .aspx/.ascx/.master。

MVC 3 (Razor ViewEngine)

protected void Application_Start() {
    AreaRegistration.RegisterAllAreas();
    ViewEngines.Engines.Clear();
    ViewEngines.Engines.Add(new MvcViewEngine());
    RegisterGlobalFilters(GlobalFilters.Filters);
    RegisterRoutes(RouteTable.Routes);
}

public class MvcViewEngine : RazorViewEngine {
    public MvcViewEngine() {
        MasterLocationFormats = new[] {
            "~/Views/Shared/{0}.cshtml"
        };
        ViewLocationFormats = new[] {
            "~/Views/Admin/{1}/{0}.cshtml",  // Admin 區域優先
            "~/Views/{1}/{0}.cshtml",
            "~/Views/Shared/{0}.cshtml"
        };
        PartialViewLocationFormats = ViewLocationFormats;
    }
}

關鍵差異:繼承 RazorViewEngine,副檔名為 .cshtml/.vbhtml。

路徑格式佔位符說明

進階客製化

  • 依 Area 分區:"~/Areas/{2}/Views/{1}/{0}.cshtml" ({2}=Area名)
  • 主題/皮膚:"~/Themes/{theme}/Views/{1}/{0}.cshtml" 需動態注入
  • 多語系:"~/Views/{1}/{0}.{culture}.cshtml"
  • 動態邏輯:覆寫 FindView/FindPartialView 方法實作複雜判斷

注意事項

  1. ViewEngines.Engines.Clear() 會移除預設引擎,確保自訂引擎為唯一或首選
  2. 路徑順序決定優先權,越前面越優先匹配
  3. 區域註冊 AreaRegistration.RegisterAllAreas() 應在引擎註冊前呼叫
  4. 效能:過多路徑會增加檔案系統檢查開銷,保持精簡
copyright © 萬盛學電腦網 all rights reserved
佔位符意義
{0}Action 名稱 (或 Partial 名稱)
{1}Controller 名稱