1. 程式人生 > >ASP.NET Core 中文文件 第四章 MVC(4.6)Areas(區域)

ASP.NET Core 中文文件 第四章 MVC(4.6)Areas(區域)

Areas 是 ASP.NET MVC 用來將相關功能組織成一組單獨名稱空間(路由)和資料夾結構(檢視)的功能。使用 Areas 建立層次結構的路由,是通過新增另一個路由引數 area 到 Controller 和 action

Areas 提供了一種把大型 ASP.NET Core MVC Web 應用程式分為較小的功能分組的方法。Area 是應用程式內部一個有效的 MVC 結構。在 MVC 專案中,像 Model,Controller 和 View 的邏輯元件放在不同的資料夾中,MVC 用命名約定來建立這些元件間的關係。對於大型應用,它有利於把應用分割成獨立高階功能的 Areas。例如,一個多業務單元的電子商務應用,如結賬,計費和搜尋等。每個單元都有自己的邏輯元件:檢視、控制器和模型。在這種情況下,你可以用 Areas 在同一專案中物理分割業務元件。

在 ASP.NET Core MVC 專案中 Area 被定義成有自己的一套 controller,view 和 model 的較小的功能單元。

當有下列情況時應當考慮在 MVC 專案中用 Areas:

  • 你的應用程式應該從邏輯上分隔成多個高階功能元件的
  • 你想要分隔你的 MVC 專案,使每一個功能 area 可以獨立工作

Area 特性:

  • 一個 ASP.NET Core MVC 應用可以有任意數量的 area
  • 每一個 area 都有自己的控制器、模型和檢視
  • 允許把大型 MVC 專案組織成多個高階元件以便可以獨立工作
  • 支援具有相同名稱的多個控制器 - 只要它們有不同的 areas

讓我們看一個例子,說明如何建立和使用 Areas。比如在一個商店應用程式裡有兩個不同分組的控制器和檢視:Products 和 Services。下一個典型的資料夾結構,使用 MVC Area 看起來像下面:

  • Project name
    • Areas
      • Products
        • Controllers
          • HomeController.cs
          • ManageController.cs
        • Views
          • Home
            • Index.cshtml
          • Manage
            • Index.cshtml
      • Services
        • Controllers
          • HomeController.cs
        • Views
          • Home
            • Index.cshtml

當 MVC 嘗試在 Area 中渲染一個檢視時,預設情況下,會嘗試在下面位置中查詢:

/Areas/<Area-Name>/Views/<Controller-Name>/<Action-Name>.cshtml
/Areas/<Area-Name>/Views/Shared/<Action-Name>.cshtml
/Views/Shared/<Action-Name>.cshtml

這些預設的位置可以通過Microsoft.AspNetCore.Mvc.Razor.RazorViewEngineOptions 的 AreaViewLocationFormats 方法被修改。

例如,在下面的程式碼中資料夾名為 ‘Areas’,它被修改為 ‘Categories’。

services.Configure<RazorViewEngineOptions>(options =>
{
    options.AreaViewLocationFormats.Clear();
    options.AreaViewLocationFormats.Add("/Categories/{2}/Views/{1}/{0}.cshtml");
    options.AreaViewLocationFormats.Add("/Categories/{2}/Views/Shared/{0}.cshtml");
    options.AreaViewLocationFormats.Add("/Views/Shared/{0}.cshtml");
});

需要注意的是 Views 資料夾結構是唯一需要重點考慮的並且剩餘資料夾像 Controllers 和 Models 的內容並不重要。比如,根本不需要 Controllers 和 Models 資料夾。這是因為 Controllers 和 Models 的內容只是編譯成一個 .dll 的程式碼不是作為 Views 的內容直到 view 被請求。

一旦定義了資料夾層次結構,需要告訴 MVC 每一個相關的 area 的 controller。用 [Area] 特性修飾控制器名稱。

...
namespace MyStore.Areas.Products.Controllers
{
    [Area("Products")]
    public class HomeController : Controller
    {
        // GET: /Products/Home/Index
        public IActionResult Index()
        {
            return View();
        }

        // GET: /Products/Home/Create
        public IActionResult Create()
        {
            return View();
        }
    }
}

用新建立的 areas 設定一個路由的定義。Routing to Controller Actions 詳細介紹瞭如何建立路由定義, 包括使用傳統路由與特性路由。在本例中,我們會用傳統路由。想這樣做, 只需開啟 Startup.cs 檔案並通過新增下邊高亮的路由定義修改它。

...
app.UseMvc(routes =>
{
  routes.MapRoute(name: "areaRoute",
    template: "{area:exists}/{controller=Home}/{action=Index}");

  routes.MapRoute(
      name: "default",
      template: "{controller=Home}/{action=Index}");
});

瀏覽 http:///products, Products area 中 HomeController 的 Index 方法將會被呼叫。

生成連結

  • 從一個基礎 controller 的 area 中的方法生成連結到同一 controller 的另一個方法。
    當前請求路徑像 /Products/Home/Create
    HtmlHelper 語法:@Html.ActionLink("Go to Product's Home Page", "Index")
    TagHelper 語法:<a asp-action="Index">Go to Product's Home Page</a>
    注意這裡不需要提供 ‘area’ 和 ‘controller’ 值因為他們在當前請求上下文中已經可用。這種值被稱作 ambient 值。

  • 從一個基礎 controller 的 area 中的方法生成連結到不同 controller 的另一個方法。
    當前請求路徑像 /Products/Home/Create
    HtmlHelper 語法:@Html.ActionLink("Go to Manage Products’ Home Page", "Index", "Manage")
    TagHelper 語法:<a asp-controller="Manage" asp-action="Index">Go to Manage Products’ Home Page</a>
    注意這裡用的 ‘area’ 環境值是上面 ‘controller’ 明確指定的。

  • 從一個基礎 controller 的 area 中的方法生成連結到不同 controller 和不同 area 另一個方法。
    當前請求路徑像 /Products/Home/Create
    HtmlHelper 語法:@Html.ActionLink("Go to Services’ Home Page", "Index", "Home", new { area = "Services" })
    TagHelper 語法:<a asp-area="Services" asp-controller="Home" asp-action="Index">Go to Services’ Home Page</a>
    注意這裡沒有環境值被用。

  • 從一個基礎 controller 的 area 中的方法生成連結到不在一個 area 中的不同 controller 的另一個方法。
    HtmlHelper 語法:@Html.ActionLink("Go to Manage Products’ Home Page", "Index", "Home", new { area = "" })
    TagHelper 語法:<a asp-area="" asp-controller="Manage" asp-action="Index">Go to Manage Products’ Home Page</a>
    因此生成連結到非 area 的基礎 controller 方法,清空了這裡 ‘area’ 的環境值。

釋出 Areas

釋出 areas 資料夾的所有 view,在 project.json 包含一個條目在 publishOptions 的 include 節點如下:

"publishOptions": {
"include": [
  "Areas/**/*.cshtml",
  ....
  ....
]

返回目錄

相關推薦

ASP.NET Core 中文 MVC4.6Areas區域

Areas 是 ASP.NET MVC 用來將相關功能組織成一組單獨名稱空間(路由)和資料夾結構(檢視)的功能。使用 Areas 建立層次結構的路由,是通過新增另一個路由引數 area 到 Controller 和 action。 Areas 提供了一種把大型 ASP.NET Core MVC Web 應用

ASP.NET Core 中文 MVC4.2控制器操作的路由

ASP.NET Core MVC 使用路由 中介軟體 來匹配傳入請求的 URL 並對映到具體的操作。路由通過啟動程式碼或者特性定義。路由描述 URL 路徑應該如何匹配到操作。路由也同樣用於生成響應中返回的 URL(用於連結)。 這篇文章將解釋 MVC 和路由之間的相互作用,以及典型的 MVC 應用程式如何使

ASP.NET Core 中文 MVC4.1Controllers, Actions 和 Action Results

Action 和 action result 是開發者使用 ASP.NET MVC 構建應用程式的基礎部分。 什麼是 Controller 在 ASP.NET MVC 中, 控制器( Controller  )用於定義和聚合操作(Action)的一個集合。操作( 或操作方法 )是控制器中處理入站請求的一個方

ASP.NET Core 中文 MVC2.3格式化響應資料

ASP.NET Core MVC 內建支援對相應資料(response data)的格式化,用來修正格式或生成客戶端指定的格式。 特定格式的操作結果 某些操作結果(Action result)的型別是指定的特定格式,比如 JsonResult 或 ContentResult。Action 可以返回格式化為

ASP.NET Core 中文 MVC4.4依賴注入和控制器

ASP.NET Core MVC 控制器應通過它們的構造器明確的請求它們的依賴關係。在某些情況下,單個控制器的操作可能需要一個服務,在控制器級別上的請求可能沒有意義。在這種情況下,你也可以選擇將服務作為 action 方法的引數。 章節: 依賴注入 依賴注入(Dependency injection,

ASP.NET Core 中文 MVC01ASP.NET Core MVC 概覽

ASP.NET Core MVC 是使用模型-檢視-控制器(Model-View-Controller)設計模式構建網頁應用與 API 的豐富的框架。 什麼是 MVC 模式? 模型-檢視-控制器(MVC)架構模式將一個應用區分為三部分主要元件:模型、檢視、與控制器。這種模式有助實現關注分離。使用這種模式,使

ASP.NET Core 中文 MVC4.3過濾器

ASP.NET MVC 過濾器 可在執行管道的前後特定階段執行程式碼。過濾器可以配置為全域性有效、僅對控制器有效或是僅對 Action 有效。 過濾器如何工作? 不同的過濾器型別會在執行管道的不同階段執行,因此它們各自有一套適用場景。根據你實際要解決的問題以及在請求管道中執行的位置來選擇建立不同的過濾器。

ASP.NET Core 中文 MVC3.8檢視中的依賴注入

ASP.NET Core 支援在檢視中使用 依賴注入 。這將有助於提供檢視專用的服務,比如本地化或者僅用於填充檢視元素的資料。你應該儘量保持控制器和檢視間的關注點分離(separation of concerns)。你的檢視所顯示的大部分資料應該從控制器傳入。 章節: 一個簡單的示例 你可以使用 @i

ASP.NET Core 中文 MVC3.7 區域性檢視partial

ASP.NET Core MVC 支援區域性檢視,當你需要在多個不同檢視間重用同一個頁面部件時會顯得特別有用。 什麼是區域性檢視? 區域性檢視是在其它檢視中被渲染的檢視。區域性檢視執行後生成的 HTML 結果會被渲染到呼叫方檢視或父檢視中。跟檢視檔案一樣,區域性檢視檔案也使用 .cshtml 作為副檔名。

ASP.NET Core 中文 MVC4.5測試控制器邏輯

ASP.NET MVC 應用程式的控制器應當小巧並專注於使用者介面。涉及了非 UI 事務的大控制器更難於測試和維護。 章節: 為什麼要測試控制器 控制器是所有 ASP.NET Core MVC 應用程式的核心部分。因此,你應當確保它們的行為符合應用的預期。 自動化測試可以為你提供這樣的保障並能夠在進入生

ASP.NET Core 中文 MVC3.9檢視元件

章節: 介紹檢視元件 檢視元件是 ASP.NET Core MVC 中的新特性,與區域性檢視相似,但是它們更加的強大。檢視元件不使用模型繫結,只取決於呼叫它時所提供的資料。檢視元件有以下特點: 渲染一個塊,而不是整個響應 在控制器和檢視之間同樣包含了關注點分離和可測試性帶來的好處 可以擁有引數和業務邏

ASP.NET Core 中文 測試5.2整合測試

整合測試確保應用程式的元件組裝在一起時正常工作。 ASP.NET Core支援使用單元測試框架和可用於處理沒有網路開銷請求的內建測試的網路主機整合測試。 章節: 整合測試介紹 整合測試驗證應用程式不同的部位是否正確地組裝在一起。不像單元測試,整合測試經常涉及到應用基礎設施,如資料庫,檔案系統,網路資源

ASP.NET Core 中文 原理2中介軟體

章節: 什麼是中介軟體 中介軟體是用於組成應用程式管道來處理請求和響應的元件。管道內的每一個元件都可以選擇是否將請求交給下一個元件、並在管道中呼叫下一個元件之前和之後執行某些操作。請求委託被用來建立請求管道,請求委託處理每一個 HTTP 請求。 請求委託通過使用 IApplicationBuilder

ASP.NET Core 中文 原理6全球化與本地化

使用 ASP.NET Core 建立一個多語言版本的網站有助於你吸引到更多的使用者,ASP.NET Core 提供服務和中介軟體來支援本地化語言和文化。 國際化涉及 全球化 和 本地化。全球化是為了應用程式支援不同文化而設計的。全球化增加了對特定地理區域的語言文字的輸入、顯示和輸出的支援。 本地化是針對一個

ASP.NET Core 中文 原理11在多個環境中工作

ASP.NET Core 介紹了支援在多個環境中管理應用程式行為的改進,如開發(development),預演(staging)和生產(production)。環境變數用來指示應用程式正在執行的環境,允許應用程式適當地配置。 章節: 開發,預演,生產 ASP.NET Core 引用了一個特定的環境變數

ASP.NET Core 中文 原理4路由

路由是用來把請求對映到路由處理程式。應用程式一啟動就配置了路由,並且可以從URL中提取值用於處理請求。它還負責使用 ASP.NET 應用程式中定義的路由來生成連結。 這份文件涵蓋了初級的ASP.NET核心路由。對於 ASP.NET 核心 MVC 路由, 請檢視 Routing to Controller A

ASP.NET Core 中文 原理13管理應用程式狀態

在 ASP.NET Core 中,有多種途徑可以對應用程式的狀態進行管理,取決於檢索狀態的時機和方式。本文簡要介紹幾種可選的方式,並著重介紹為 ASP.NET Core 應用程式安裝並配置會話狀態支援。 應用程式狀態的可選方式 應用程式狀態 指的是用於描述應用程式當前狀況的任意資料。包括全域性的和使用者特

ASP.NET Core 中文 原理1應用程式啟動

ASP.NET Core 為你的應用程式提供了處理每個請求的完整控制。Startup 類是應用程式的入口(entry point),這個類可以設定配置(configuration)並且將應用程式將要使用的服務連線起來。開發人員可以在 Startup 類中配置請求管道,該管道將用於處理應用程式的所有請求。 章

ASP.NET Core 中文 原理16.NET開放Web介面OWIN

ASP.NET Core 支援 OWIN(即 Open Web Server Interface for .NET 的首字母縮寫),OWIN的目標是用於解耦Web Server和Web Application。此外, OWIN為中介軟體定義了一個標準方法用來處理單個請求以及相關聯的響應。ASP.NET Co

ASP.NET Core 中文 原理17為你的伺服器選擇合適版本的.NET框架

ASP.NET Core基於 .NET Core 專案模型,它支援構建能夠執行在 Windows、Mac和 Linux 上的跨平臺應用程式。當您構建一個 .Net Core 專案的時候,您可以選擇一種 .NET框架來構建您的應用程式,.NET Framework (CLR)、 .NET Core (Core