Areas(区域)

Areas(区域),第1张

Areas(区域) 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",
....
....
]
 

返回目录

本文发表于博客园《行者自若的技术笔记》,作者为Forerunner(Alex-LEWIS/行者自若)
文章地址:http://www.cnblogs.com/dotNETCoreSG/p/aspnetcore-4_4_6-areas.html
原创授权为:署名 - 非商业性使用 - 禁止演绎,协议普通文本 | 协议法律文本

欢迎分享,转载请注明来源:内存溢出

原文地址: http://outofmemory.cn/zaji/585863.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2022-04-12
下一篇 2022-04-12

发表评论

登录后才能评论

评论列表(0条)

保存