[译]ASP.NET Core 2.0 区域

问题

如何将一个规模庞大的ASP.NET Core 2.0应用程序进行逻辑分组?

答案

新建一个ASP.NET Core 2.0空项目,修改Startup类,增加Mvc服务和中间件:

public void ConfigureServices(IServiceCollection services)
{
	services.AddMvc();
}

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
	if (env.IsDevelopment())
	{
		app.UseDeveloperExceptionPage();
	}

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

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

创建目录结构如下所示:

 

向Controllers和Views目录中添加文件(其中Area1的目录结构如下):

 

向Area1和Area2目录中的控制器类添加[Area]特性:

namespace Areas.Areas.Area1.Controllers
{
    [Area("Area1")]
    public class HomeController : Controller
    {
        public IActionResult Index()
        {
            return View();
        }
        public IActionResult About()
        {
            return View();
        }
    }
}

运行,此时页面显示:

 

点击超链接Area1/Home/Index,页面显示:

 

返回首页,点击超链接Area2/Home/Index,页面显示:

 

讨论

MVC使用模型、视图和控制器来分离应用程序的关注点。对于更大的应用程序,区域提供了一种将这三个关注点隔离到更高级别分组中的方法。例如,你可能希望将应用程序分隔成不同的模块,每个模块都包含自己的MVC结构。

为了支持路由,还有另外一个路由参数area(作为对controller和action参数的补充)。你可以将区域假想为控制器的命名空间。在当前请求上下文中,area路由参数也可以作为环境变量存在(无需显示提供)。下面的示例中,由于页面存在于Area1区域中,所以链接到本区域的超链接省略了area参数(下面小节会详细讨论):

<p><strong>You are here: </strong>Area1/Home/Index</p>

<ul>
    <li><a asp-area="" asp-controller="Home" asp-action="Index">Home/Index</a></li>
    <li><a asp-area="" asp-controller="Home" asp-action="About">Home/About</a></li>
    <li><a asp-controller="Home" asp-action="Index">Area1/Home/Index</a></li>
    <li><a asp-controller="Home" asp-action="About">Area1/Home/About</a></li>
    <li><a asp-area="Area2" asp-controller="Home" asp-action="Index">Area2/Home/Index</a></li>
    <li><a asp-area="Area2" asp-controller="Home" asp-action="About">Area2/Home/About</a></li>
</ul>

为了在项目中使用区域,你首先需要创建一个以Areas命名的目录和每个具体的区域(包含其控制器、模型和视图)。注意目录结构的命名非常重要,因为MVC会按照如下顺序查找视图所在的位置:

 

一旦目录结构创建成功,你就可以通过[Area]特性来标识每个控制器了:

[Area("Area1")]
public class HomeController : Controller
{
}

生成链接

下面表格列出了生成超链接所需要的路由参数,其中From为超链接所在的页面,To为超链接需要跳转的页面,链接格式为:{area}/{controller}/{action}。

如果省略路由参数,则意味着MVC会从当前请求上下文中检索这些参数。为了便于维护,我个人觉得还是为每个路由参数都设置值来得方便。这篇文章所附带的示例工程包含了不同页面上的超链接,你可以观察环境变量值是如何工作的:

From   To 路由参数 
 Area1/Controller1/Action1  Area1/Controller1/Action2  asp-action="Action2"
 Area1/Controller1/Action1  Area1/Controller2/Action1  asp-controller="Controller2"
 asp-action="Action1"
 Area1/Controller1/Action1  Area2/Controller1/Action1  asp-area="Area2"
 asp-controller="Controller1"
 asp-action="Action1"
Area1/Controller1/Action1 Controller1/Action1  asp-area=""
 asp-controller="Controller1"
 asp-action="Action1"

 

布局页面

区域内部的Razor视图可以使用外面的布局页面(也就是根目录下的/Views/Shared)。当然你可以为每个区域定义不同的布局页面。另外一种方法就是在外部定义公共的布局页面,然后区域内的布局页面将其作为页面布局,从而创建一个嵌套的布局页面。下面显示了Area2区域的布局页面如何使用外部布局页面(注意为了引用外部布局页面,你需要指定绝对路径):

@{ 
    Layout = "/Views/Shared/_Layout.cshtml";
}

<div>
    <nav style="background-color: lightgray">
        <h2>Area2 Layout</h2>
    </nav>
    @RenderBody()
</div>

源代码下载

 

原文:https://tahirnaushad.com/2017/08/25/asp-net-core-2-0-mvc-areas/

 

ASP.NET Core 2.0 系列文章目录

posted @ 2017-11-09 09:13 三生石上(FineUI控件) 阅读(...) 评论(...) 编辑 收藏