菜鸟科技网

cshtml如何加载另一个cshtml页面?

在ASP.NET Core MVC框架中,CSHTML文件是Razor视图引擎的核心组成部分,用于生成动态的HTML内容,在CSHTML页面中加载另一个CSHTML页面,通常被称为“视图包含”或“视图复用”,是提高代码复用性和模块化开发的重要手段,以下是几种常见的实现方式及其详细说明。

cshtml如何加载另一个cshtml页面?-图1
(图片来源网络,侵删)

使用Partial View(部分视图)

部分视图是一种可重用的视图组件,通常用于渲染页面的某个片段,如页头、页脚、侧边栏等,在父视图中加载部分视图,主要有以下两种方法:

(1)Html.Partial方法

Html.Partial是一个同步方法,直接返回一个字符串形式的HTML内容,它不会改变当前视图的上下文,适用于静态或数据量较小的部分视图。

@* 在父视图中直接调用 *@
@Html.Partial("_HeaderPartial")

(2)Html.RenderPartial方法

Html.RenderPartial是一个异步方法,通过HtmlHelperRenderPartialAsync方法实现,它直接将HTML写入响应流,性能上优于Html.Partial,尤其适合大数据量的部分视图。

@* 在父视图中使用 *@
@{
    await Html.RenderPartialAsync("_FooterPartial");
}

注意事项:部分视图默认位于/Views/Shared/或当前视图所在的/Views/ControllerName/文件夹中,文件名以下划线_开头是约定俗成的做法,但并非强制。

cshtml如何加载另一个cshtml页面?-图2
(图片来源网络,侵删)

使用View Component(视图组件)

视图组件是一种更强大的复用机制,支持业务逻辑处理和数据封装,它类似于控制器中的Action,但更适合处理可重用的UI组件。

(1)创建视图组件

首先创建一个继承自ViewComponent的类,并实现InvokeAsync方法:

public class MenuViewComponent : ViewComponent
{
    public async Task<IViewComponentResult> InvokeAsync()
    {
        var menuItems = await GetMenuDataAsync(); // 获取数据逻辑
        View("Default", menuItems); // 指定视图名称和模型
    }
}

(2)引用视图组件

在CSHTML页面中使用@await Component.InvokeAsync方法调用:

@* 调用视图组件 *@
@await Component.InvokeAsync("Menu", new { filter = "top" })

视图组件的默认视图应位于/Views/Shared/Components/{组件名}/Default.cshtml路径下。

使用Layout布局页面

Layout页面用于定义整体页面结构,如<head><body>等公共部分,子视图通过指定Layout属性继承布局,并在@RenderBody()@RenderSection()位置填充内容。

(1)定义Layout

_Layout.cshtml中定义占位符:

<body>
    <header>@RenderSection("Header", required: false)</header>
    <main>@RenderBody()</main>
    <footer>@RenderSection("Footer", required: false)</footer>
</body>

(2)子视图引用Layout

在子视图开头指定Layout:

@{
    Layout = "_Layout";
}
@section Header {
    <h1>自定义页头</h1>
}

使用Section(节)

Section允许子视图向Layout页面提供特定内容,如页眉、页脚等,通过@RenderSection方法在Layout中渲染。

@* Layout中 *@
@section Scripts {
    <script src="custom.js"></script>
}

直接返回其他视图

在控制器中,可以通过return View("视图名")直接加载另一个CSHTML页面,但这属于控制器层面的操作,而非视图间的直接调用。

方法对比

方法 适用场景 性能 支持逻辑 备注
Html.Partial 静态或小型UI片段 较低 不支持 同步渲染,返回字符串
Html.RenderPartial 大型UI片段 较高 不支持 异步渲染,直接输出
View Component 复杂UI组件+逻辑 支持 封装业务逻辑,可复用性强
Layout 整体页面结构 不支持 定义公共模板
Section 自定义布局内容 不支持 需配合Layout使用

相关问答FAQs

Q1:Partial View和View Component有什么区别?
A1:Partial View主要用于简单的UI片段复用,不支持业务逻辑;而View Component支持数据封装和逻辑处理,适合构建复杂的可复用组件,View Component的灵活性更高,但实现稍复杂。

Q2:如何在Layout中动态加载不同的Partial View?
A2:可以在Layout中定义@RenderSection@Html.Partial,并通过子视图的@section或模型传递动态参数,在Layout中使用@Html.Partial("_DynamicPartial", Model),子视图通过Model传递不同的Partial View名称或数据。

分享:
扫描分享到社交APP
上一篇
下一篇