Areas（區(qū)域）

原文：Areas
作者：Dhananjay Kumar和Rick Anderson
翻譯：耿曉亮(Blue)
校對(duì)：許登洋(Seay)

Areas 是 ASP.NET MVC 用來(lái)將相關(guān)功能組織成一組單獨(dú)命名空間（路由）和文件夾結(jié)構(gòu)（視圖）的功能。使用 Areas 創(chuàng)建層次結(jié)構(gòu)的路由，是通過(guò)添加另一個(gè)路由參數(shù)area到Controller和action。

Areas 提供了一種把大型 ASP.NET Core MVC Web 應(yīng)用程序分為較小的功能分組的方法。Area 是應(yīng)用程序內(nèi)部一個(gè)有效的 MVC 結(jié)構(gòu)。在 MVC 項(xiàng)目中，像 Model，Controller 和 View 的邏輯組件放在不同的文件夾中，MVC 用命名約定來(lái)創(chuàng)建這些組件間的關(guān)系。對(duì)于大型應(yīng)用，它有利于把應(yīng)用分割成獨(dú)立高級(jí)功能的 Areas。例如，一個(gè)多業(yè)務(wù)單元的電子商務(wù)應(yīng)用，如結(jié)賬，計(jì)費(fèi)和搜索等。每個(gè)單元都有自己的邏輯組件：視圖、控制器和模型。在這種情況下，你可以用 Areas 在同一項(xiàng)目中物理分割業(yè)務(wù)組件。

在 ASP.NET Core MVC 項(xiàng)目中 Area 被定義成有自己的一套 controller，view 和 model 的較小的功能單元。

當(dāng)有下列情況時(shí)應(yīng)當(dāng)考慮在 MVC 項(xiàng)目中用 Areas：

你的應(yīng)用程序應(yīng)該從邏輯上分隔成多個(gè)高級(jí)功能組件的
你想要分隔你的 MVC 項(xiàng)目，使每一個(gè)功能 area 可以獨(dú)立工作

Area 特性：

一個(gè) ASP.NET Core MVC 應(yīng)用可以有任意數(shù)量的 area
每一個(gè) area 都有自己的控制器、模型和視圖
允許把大型 MVC 項(xiàng)目組織成多個(gè)高級(jí)組件以便可以獨(dú)立工作
支持具有相同名稱(chēng)的多個(gè)控制器 - 只要它們有不同的areas

讓我們看一個(gè)例子，說(shuō)明如何創(chuàng)建和使用 Areas。比如在一個(gè)商店應(yīng)用程序里有兩個(gè)不同分組的控制器和視圖：Products 和 Services。下一個(gè)典型的文件夾結(jié)構(gòu)，使用 MVC Area 看起來(lái)像下面：

Project name
Areas

Products
Controllers

HomeController.cs
ManageController.cs

Views

Home
Index.cshtml
Manage
Index.cshtml

Services
Controllers

HomeController.cs

Views

Home
Index.cshtml

當(dāng) MVC 嘗試在 Area 中渲染一個(gè)視圖時(shí)，默認(rèn)情況下，會(huì)嘗試在下面位置中查找：

復(fù)制代碼

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

這些默認(rèn)的位置可以通過(guò)Microsoft.AspNetCore.Mvc.Razor.RazorViewEngineOptions的AreaViewLocationFormats方法被修改。

例如，在下面的代碼中文件夾名為 ‘Areas’，它被修改為 ‘Categories’。

復(fù)制代碼

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 文件夾結(jié)構(gòu)是唯一需要重點(diǎn)考慮的并且剩余文件夾像 Controllers 和 Models 的內(nèi)容并不重要。比如，根本不需要 Controllers 和 Models 文件夾。這是因?yàn)?Controllers 和 Models 的內(nèi)容只是編譯成一個(gè) .dll 的代碼不是作為 Views 的內(nèi)容直到 view 被請(qǐng)求。

一旦定義了文件夾層次結(jié)構(gòu)，需要告訴 MVC 每一個(gè)相關(guān)的 area 的 controller。用[Area]特性修飾控制器名稱(chēng)。

復(fù)制代碼

...
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();
        }
    }
}

用新創(chuàng)建的 areas 設(shè)置一個(gè)路由的定義。Routing to Controller Actions詳細(xì)介紹了如何創(chuàng)建路由定義, 包括使用傳統(tǒng)路由與特性路由。在本例中，我們會(huì)用傳統(tǒng)路由。想這樣做, 只需打開(kāi)Startup.cs文件并通過(guò)添加下邊高亮的路由定義修改它。

復(fù)制代碼

...
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，Productsarea 中HomeController的Index方法將會(huì)被調(diào)用。

生成鏈接

從一個(gè)基礎(chǔ) controller 的 area 中的方法生成鏈接到同一 controller 的另一個(gè)方法。
當(dāng)前請(qǐng)求路徑像/Products/Home/Create
HtmlHelper 語(yǔ)法：@Html.ActionLink("GotoProduct'sHomePage","Index")
TagHelper 語(yǔ)法：<aasp-action="Index">GotoProduct'sHomePage</a>
注意這里不需要提供 ‘area’ 和 ‘controller’ 值因?yàn)樗麄冊(cè)诋?dāng)前請(qǐng)求上下文中已經(jīng)可用。這種值被稱(chēng)作ambient值。

從一個(gè)基礎(chǔ) controller 的 area 中的方法生成鏈接到不同 controller 的另一個(gè)方法。
當(dāng)前請(qǐng)求路徑像/Products/Home/Create
HtmlHelper 語(yǔ)法：@Html.ActionLink("GotoManageProducts’HomePage","Index","Manage")
TagHelper 語(yǔ)法：<aasp-controller="Manage"asp-action="Index">GotoManageProducts’HomePage</a>
注意這里用的 ‘area’ 環(huán)境值是上面 ‘controller’ 明確指定的。

從一個(gè)基礎(chǔ) controller 的 area 中的方法生成鏈接到不同 controller 和不同 area 另一個(gè)方法。
當(dāng)前請(qǐng)求路徑像/Products/Home/Create
HtmlHelper 語(yǔ)法：@Html.ActionLink("GotoServices’HomePage","Index","Home",new{area="Services"})
TagHelper 語(yǔ)法：<aasp-area="Services"asp-controller="Home"asp-action="Index">GotoServices’HomePage</a>
注意這里沒(méi)有環(huán)境值被用。

從一個(gè)基礎(chǔ) controller 的 area 中的方法生成鏈接到不在一個(gè) area 中的不同 controller 的另一個(gè)方法。
HtmlHelper 語(yǔ)法：@Html.ActionLink("GotoManageProducts’HomePage","Index","Home",new{area=""})
TagHelper 語(yǔ)法：<aasp-area=""asp-controller="Manage"asp-action="Index">GotoManageProducts’HomePage</a>
因此生成鏈接到非 area 的基礎(chǔ) controller 方法，清空了這里 ‘area’ 的環(huán)境值。

發(fā)布 Areas

發(fā)布 areas 文件夾的所有 view，在 project.json 包含一個(gè)條目在publishOptions的include節(jié)點(diǎn)如下：

復(fù)制代碼

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

返回目錄

本文發(fā)表于博客園《行者自若的技術(shù)筆記》，作者為Forerunner（Alex-LEWIS/行者自若）
文章地址：http://www.cnblogs.com/dotNETCoreSG/p/aspnetcore-4_4_6-areas.html
原創(chuàng)授權(quán)為：署名 - 非商業(yè)性使用 - 禁止演繹，協(xié)議普通文本|協(xié)議法律文本

總結(jié)

以上是生活随笔為你收集整理的Areas（区域）的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。