[译]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: "default",
template: "{controller=Home}/{action=Index}/{id?}");
});
}

添加两个模型:

public class EmployeeViewModel
{
public int Id { get; set; }
public string Firstname { get; set; }
public string Surname { get; set; }
public AddressViewModel Address { get; set; }
} public class AddressViewModel
{
public string Line1 { get; set; }
public string Line2 { get; set; }
public string Line3 { get; set; }
}

添加控制器,返回ViewResult并传入模型实例:

public class HomeController : Controller
{
public IActionResult Index()
{
var model = new EmployeeViewModel
{
Id = 1,
Firstname = "James",
Surname = "Bond",
Address = new AddressViewModel
{
Line1 = "Secret Location",
Line2 = "London",
Line3 = "UK"
}
};
return View(model);
}
}

添加视图页面Index.cshtml:

@using PartialView.Models;
@model EmployeeViewModel <div style="border: 1px solid black; margin: 5px">
<h2>Employee Details (parent view)</h2> <p>Firstname: @Model.Firstname</p>
<p>Surname: @Model.Surname</p> @Html.Partial("_Address.cshtml", Model.Address)
</div>

添加部分视图_Address.cshtml:

@using PartialView.Models
@model AddressViewModel <div style="border: 1px dashed red; margin: 5px">
<h3>Address Details (partial view)</h3> <p>Lin1: @Model.Line1</p>
<p>Line2: @Model.Line2</p>
<p>Line3: @Model.Line3</p>
</div>

现在,解决方案中的目录结构:

[译]ASP.NET Core 2.0 部分视图

运行,此时页面显示:

[译]ASP.NET Core 2.0 部分视图

讨论

部分视图是一种渲染到其他视图内部的特殊视图。对于重用视图的部分结构或者将一个大视图分隔为一些小组件,这将非常有用。

部分视图可以像正常视图一样被创建,并且可以通过控制器方法来返回ViewResult。关键的区别在于部分视图渲染之前不运行_ViewStart.cshtml,并且它通常会被渲染到其他视图的内部。

在视图内部,部分视图通过@Html.Partial()方法来渲染,并且传入部分视图的名称和一个可选的模型实例。部分视图名称可以是绝对或者相对路径,视图引擎会在当前目录和Shared目录中查找相应的部分视图。

部分视图能获取父视图ViewData数据的一个拷贝。你还可以向其中传入模型,这通常是父视图模型的一部分。

注:ASP.NET Core还提供了另外一种更加灵活的解决方案来重用或者分隔视图,这种解决方案不仅可以运行代码,而且无需依赖父视图。它就是视图组件,下一节我们就会介绍。

源代码下载

原文:https://tahirnaushad.com/2017/08/24/asp-net-core-2-0-mvc-partial-views/

上一篇:[译]ASP.NET Core 2.0 全局配置项


下一篇:『TCP/IP详解——卷一:协议』读书笔记——12