Blazor混合托管场景下在_Layout.cshtml加载Razor组件的方法
在Blazor Server托管的Razor页面布局中嵌入Razor组件
前置准备
- 确认服务端项目已注册Blazor Server相关服务,且正确映射Blazor Hub端点:
- .NET 6+ 项目在
Program.cs中配置:builder.Services.AddServerSideBlazor(); // ... 其他原有配置 app.MapBlazorHub();
blazor.server.js,通常项目已经完成了这部分配置,仅需确认即可。 - .NET 6+ 项目在
核心实现步骤
引入组件所在命名空间
由于普通Razor Pages(.cshtml)视图无法自动识别Razor组件的命名空间,需要在_Layout.cshtml的最顶部,或者全局的_ViewImports.cshtml文件中,添加MyComponent对应的命名空间引用:@using MyApp.Server.Pages.Components注意:Razor组件专用的全局导入文件
_Imports.razor对.cshtml视图不生效,必须在视图体系内单独导入命名空间。如果MyComponent.razor文件内通过@namespace指令自定义了根命名空间,需要以自定义的命名空间为准导入。在布局占位位置渲染组件
在_Layout.cshtml中原本需要插入组件的位置,使用ASP.NET Core内置的component标签帮助器渲染组件,匹配Blazor Server的运行模式:<component type="typeof(MyComponent)" render-mode="Server" />
修改完成后的完整_Layout.cshtml代码
@using MyApp.Server.Pages.Components <!DOCTYPE html> <html> <head> <title>@ViewBag.Title</title> <link href="/lib/twitter-bootstrap/css/bootstrap.min.css" rel="stylesheet" /> <base href="~/" /> </head> <body> <div> 布局头部 @* 此处插入Razor组件 *@ <component type="typeof(MyComponent)" render-mode="Server" /> </div> <div class="m-2"> @RenderBody() </div> <script src="_framework/blazor.server.js"></script> </body> </html>
效果说明
按上述配置完成后,页面输出顺序会完全匹配预期:
- 首先输出布局头部内容
- 紧接着输出MyComponent的服务端渲染HTML内容,待页面加载完成后,
blazor.server.js会自动为该组件建立实时交互连接,支持Blazor Server模式下的事件绑定、状态更新等能力 - 最后输出
@RenderBody()渲染的Index页面内容
常见避坑提示
- 不要在.cshtml视图中直接使用
<MyComponent />的Razor组件语法,该语法仅在.razor组件文件内生效,普通cshtml视图必须通过component标签帮助器完成组件嵌入 - 如果需要向组件传递参数,可通过标签的
param-前缀属性配置,例如:
只要组件内定义了对应的<component type="typeof(MyComponent)" render-mode="Server" param-CustomValue="测试参数" />[Parameter]属性,即可正常接收传值 - 该实现与项目中WebAssembly托管的离线页面逻辑无冲突,两套Blazor运行时可通过独立的路由路径共存,满足混合模式站点的需求
内容的提问来源于stack exchange,提问作者Neil W
相关产品推荐
相关产品推荐

