推荐
关注
功能
  • 分享到微博
  • 分享到微信
  • 分享到豆瓣
  • 分享到 QQ
  • 分享到 QZone
  • 收藏到博客园
  • 联系博主
TOP
Message

ASP.NET Core 中文文档 第四章 MVC(4.6)Areas(区域)

原文:Areas
作者:Dhananjay Kumar 和 Rick Anderson
翻译:耿晓亮(Blue)
校对:许登洋(Seay)

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",
  ....
  ....
]

返回目录

posted @ 2016-10-12 11:30 .NET_CORE_COMMUNITY 阅读(...) 评论(...) 编辑 收藏