ASP.NET MVC 預設視圖搜尋路徑為 ~/Views/{Controller}/{Action}.cshtml 等。專案需求常需調整結構 (如依區域、模組、主題分類),需自訂 ViewEngine。
ViewLocationFormats、MasterLocationFormats、PartialViewLocationFormats 屬性Global.asax Application_Start 中註冊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。
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。
| 佔位符 | 意義 |
|---|---|
| {0} | Action 名稱 (或 Partial 名稱) |
| {1} | Controller 名稱 |