Blazor 怎么在 Code-behind 文件中写逻辑

来源：这里教程网时间：2026-02-21 17:35:02 作者：

Blazor 中的 Code-behind 是一种将组件的 UI（.razor 文件）和 C# 逻辑（.razor.cs 文件）分离的方式，适合管理较复杂或需复用的业务逻辑。它不是 Blazor 官方强制推荐的模式（官方倾向使用 @code 块或独立服务），但完全支持，且在团队协作、测试友好性、代码分层等方面有实际价值。

Code-behind 的基本写法

要启用 Code-behind，需满足两个条件：文件命名一致 + 继承关系正确。

.razor 文件只保留标记（HTML/Blazor 指令），不写 @code 块；顶部用
@inherits
显式指定基类（即 .razor.cs 中的类） .razor.cs 文件需继承
ComponentBase
，并用 partial 声明与 .razor 同名的部分类

例如：

Counter.razor

@inherits CounterBase
<h1>当前计数：@currentCount</h1>
<button class="btn btn-primary" @onclick="IncrementCount">点击加一</button>

Counter.razor.cs

public partial class CounterBase : ComponentBase
{
    protected int currentCount = 0;
<pre class="brush:php;toolbar:false;">protected void IncrementCount()
{
    currentCount++;
    StateHasChanged(); // 如需手动触发重渲染（通常事件中自动触发，此处可省略）
}

}

访问 Razor 页面中的成员（参数、状态、生命周期）

Code-behind 类天然拥有对组件上下文的访问能力，只要按标准方式声明即可：

用
[Parameter]
属性接收父组件传入的参数（在 .razor.cs 中定义）生命周期方法（
OnInitialized
、
OnParametersSet
、
OnAfterRender
等）直接重写即可
NavigationManager
、
JSRuntime
等服务可通过
[Inject]
注入（需确保该类是 partial 且继承 ComponentBase）

示例：

public partial class CounterBase : ComponentBase
{
    [Inject] public NavigationManager Navigation { get; set; } = default!;
    [Parameter] public int InitialValue { get; set; } = 0;
    protected int currentCount = 0;
<pre class="brush:php;toolbar:false;">protected override void OnInitialized()
{
    currentCount = InitialValue;
}
protected void NavigateHome() => Navigation.NavigateTo("/");

}

注意事项和常见坑

Code-behind 不是“魔法”，它依赖编译器对 partial 类的合并，因此必须严格遵守规则：

两个文件的命名必须完全一致（如
MyPage.razor
和
MyPage.razor.cs
），且在同一目录下 .razor.cs 中的类必须是
public partial
，且继承
ComponentBase
（或其子类）不要在 .razor 中再写
@code
块，否则会引发编译错误（partial 类重复定义）如果用了
@page
，仍需写在 .razor 文件顶部（
@page "/counter"
），.razor.cs 不处理路由

什么时候值得用 Code-behind？

它更适合以下场景：

组件逻辑较重，想把数据处理、状态机、表单验证等抽离出来，便于单元测试 需要多页面共享同一套组件基类（比如带权限检查、日志记录的 BasePage） 团队习惯 MVVM 或传统 Web Forms 风格，希望 UI 和逻辑物理隔离 生成代码或模板引擎输出的组件，需要稳定接口契约

对于简单组件，直接用