原文:Partial Views
作者:Steve Smith
翻译:张海龙(jiechen)、刘怡(AlexLEWIS)
校对:许登洋(Seay)、何镇汐、魏美娟(初见)
Core MVC 支持局部视图,当你需要在多个不同视图间重用同一个页面部件时会显得特别有用。
什么是局部视图?
局部视图是在其它视图中被渲染的视图。局部视图执行后生成的 HTML 结果会被渲染到调用方视图或父视图中。跟视图文件一样,局部视图文件也使用.cshtml作为文件扩展名。
注解
如果你有 Web Forms 的开发背景,那么局部视图就比较类似于你以前用过的 用户控件
何时使用局部视图?
局部视图是将大视图分解为小组件的有效方式。它可以减少视图内容的重复并允许视图元素复用。通用的布局元素应该写在 _Layout.cshtml 中。非布局(non-layout)的重用内容则可封装到局部视图之中。
如果你有一个由多个逻辑块构成的复杂页面,那么将每个逻辑块都作为局部视图是很有用的。页面的每一个部分都可视为独立于其他部分,而页面本身也会变得简单很多,因为它只包含页面的整体结构并调用渲染各局部视图。
小技巧
在你的视图中遵从 不要使自己重复原则 。
定义局部视图
创建局部视图与创建其它视图类似:你在Views文件夹中添加一个.cshtml文件。局部视图与普通视图之间没有语义级的区别,它们只是渲染上有所不同。你可以直接从控制器的 ViewResult 返回一个视图,而这个视图也可当做局部视图来用。两类视图的主要区别在于渲染上的不同:局部视图不会运行 _ViewStart.cshtml (普通视图则会运行。了解更多 _ViewStart.cshtml 的信息请访问 布局视图)。
引用局部视图
有多种方法在视图中渲染局部视图。最简单的办法是使用Html.Partial
,它通过@
前缀来调用并返回IHtmlContent
:
@Html.Partial("AuthorPartial")
PartialAsync方法对包含异步代码(尽管通常在视图中不推荐这么做)的局部视图是可用的。
@await Html.PartialAsync("AuthorPartial")
可以使用RenderPartial渲染局部视图。这个方法不返回结果;它将渲染结果直接输出到响应中。正因为它不返回结果,所以必须在 Razor 代码块中调用(当然如果有必要,你也可以调用RenderPartialAsync
方法):
@{Html.RenderPartial("AuthorPartial");}
因为会直接输出结果,RenderPartial
和RenderPartialAsync
方法可能在一些场景下表现更佳。但是,在大多数情况下推荐你使用Partial
和PartialAsync
这两个方法。
注解
如果你的视图需要执行代码,推荐你使用 视图组件 来替代局部视图。
发现局部视图
当引用局部视图的时候,你可以通过多种方式找到它的位置:
// 以视图名使用当前文件夹下的视图// 如果没有找到,则搜索 Shared 文件夹@Html.Partial("ViewName")// 这个名称的视图必须在相同文件夹下@Html.Partial("ViewName.cshtml")// 依据应用根路径定位视图// 以 "/" 或 "~/" 开头的路径代表应用根路径@Html.Partial("~/Views/Folder/ViewName.cshtml")@Html.Partial("/Views/Folder/ViewName.cshtml")// 使用相对路径定位视图@Html.Partial("../Account/LoginPartial.cshtml")
若需要,你可以在不同的视图文件夹下存放同名的不同局部视图。当根据视图名称(不包括文件扩展名)来引用视图时,视图将使用其所在的文件夹下的局部视图。当然你也可以指定并使用默认位于Shared文件夹下的局部视图,这个视图可被任意视图(前提是在它们的文件夹下不存在这个局部视图)使用。换句话说,你可以在Shared文件夹下放置默认的局部视图,该默认局部视图会被当前执行视图所在文件夹下的同名局部视图所覆盖。
局部视图可以被连续地链式使用 。这个意思是说一个局部视图可以调用另一个局部视图(只要你不要创建循环)。在每个视图或局部视图中,相对路径总是相对于所在视图,而非根路径或父视图。
注解
如果你在局部视图中定义 Razor
section
,将对其父级不可见;将被限定在局部视图。
从局部视图访问数据
当局部视图被实例化,它获得父视图的ViewData
字典的副本。在局部视图中对该字典副本进行的修改不会影响到父视图中的字典。 当局部视图返回时,将丢弃局部视图中的ViewData
副本。
你可以传递ViewDataDictionary
的实例到局部视图:
@Html.Partial("PartialName", customViewData)
你也可以传递模型到局部视图。该模型可以是页面的视图模型(view model),也可以是视图模型的一部分,亦或者是其他自定义对象。只需要在调用Partial
/PartialAsync
或RenderPartial
/RenderPartialAsync
时简单地把模型作为第二个参数传入。
@Html.Partial("PartialName", viewModel)
你可以传递一个ViewDataDictionary
的实例和视图模型到局部视图:
@Html.Partial("PartialName", viewModel, customViewData)
示例
下例中,视图指定了Article
类型的视图模型。Article
有一个AuthorName
属性,它被传递到一个叫做AuthorPartial的局部视图中;同时还有一个List<ArticleSection>
类型的属性,它被传递到一个专用于渲染此类型的局部视图:
@using PartialViewsSample.ViewModels@model Article<h2>@Model.Title</h2>@Html.Partial("AuthorPartial", Model.AuthorName)@Model.PublicationDate@foreach (var section in @Model.Sections){@Html.Partial("ArticleSection", section)}
AuthorPartial(此例中在/Views/Shared文件夹):
@model string<div><h3>@Model</h3>This partial view came from /Views/Shared/AuthorPartial.cshtml.<br/></div>
ArticleSection部分:
@using PartialViewsSample.ViewModels@model ArticleSection<h3>@Model.Title</h3><div>@Model.Content</div>
在运行时,这些局部视图将被渲染到父视图,父视图自身在共享的_Layout.cshtml中被渲染,输出结果如下: