.NET控制台应用在MVC外使用Razor组件时布局不渲染

在.NET 8控制台应用中渲染Razor组件时，默认的静态组件渲染器不会自动处理@layout指令，导致布局组件未被渲染，仅显示目标组件内容。

解决步骤 #

要让布局生效，需要在创建StaticComponentRenderer实例时显式启用布局支持：

var renderer = new StaticComponentRenderer()
    .EnableLayouts(); // 启用布局解析与渲染

var html = await renderer.RenderComponentAsync<Documents>(
    parameters: new { Message = "Hello from the Render Message component!" });

说明 #

• 你的Documents.razor和Email.razor组件代码本身没有问题，Email.razor继承LayoutComponentBase并使用@Body承载内容的写法是正确的。
• 默认情况下StaticComponentRenderer为了性能优化，会跳过布局处理逻辑，必须通过EnableLayouts()方法开启布局支持，渲染器才会解析组件上的@layout声明，将组件内容嵌入到布局对应的位置。

内容的提问来源于stack exchange，提问作者Andrew