EventCallback 是 Blazor 专用于子组件向父组件发起异步回调通知的线程安全委托包装器,自动处理 UI 线程同步与状态刷新;Action/Func 是通用委托,无 Blazor 运行时语义,调用后不会触发自动渲染。

Blazor 中的 EventCallback 不是普通委托,而是专为组件通信设计的异步通知机制;它和 Action、Func 本质不同——后两者是通用委托类型,而 EventCallback 是 Blazor 框架封装的“可跨渲染上下文安全调用”的委托包装器。
核心区别:用途与线程安全
EventCallback 是 Blazor 的“事件管道”,用于子组件向父组件发起**异步回调通知**,内部自动处理同步上下文(比如确保在 UI 线程触发状态刷新)。Action/Func 是纯 .NET 委托,不带任何 Blazor 运行时语义:
- EventCallback 必须由父组件通过
[Parameter]传入,且只能被子组件通过InvokeAsync()调用 - Action/Func 可以直接 new、lambda 创建,也能作为参数传递,但调用后不会触发 Blazor 的重新渲染(除非手动调用
StateHasChanged()) - EventCallback 支持泛型(
EventCallback),天然适配绑定场景(如@bind-Value底层就是EventCallback) - Action/Func 无法直接替代 EventCallback——若把 Action 当 EventCallback 传给子组件,子组件调用时会丢失渲染上下文,可能导致 UI 不更新或异常
典型用法对比
假设子组件要通知父组件“用户点了确认按钮”:
- ✅ 正确用法(EventCallback):
父组件传:
子组件定义:[Parameter] public EventCallback OnConfirmed { get; set; }
子组件触发:await OnConfirmed.InvokeAsync(); - ❌ 错误类比(Action):
若父组件传OnConfirmed="() => HandleConfirm()"(Action),子组件调用OnConfirmed()虽能执行逻辑,但 Blazor 不知道该刷新 UI,且可能在非渲染线程执行 - ⚠️ Func 可用于计算,但不适用通知场景:
Func—— 返回值有用,但不能“触发父组件响应”GetTitle => "确认弹窗";
什么时候该用哪个?
按角色判断最直观:
- 需要子 → 父「发消息」(点击、保存、关闭、验证通过等)→ 用 EventCallback
- 需要父 → 子「传行为」但不要求 Blazor 协调(比如日志打印、本地数据预处理)→ 可用 Action
- 需要父 → 子「传计算逻辑」(比如格式化函数、过滤规则)→ 用 Func
- 多个参数或复杂签名?EventCallback 支持泛型(
EventCallback不合法,但EventCallback或自定义类型可);Action/Func 天然支持多参(Action)
基本上就这些。用对 EventCallback,组件通信才真正“受控”;混用 Action/Func 虽语法能过,但容易绕过 Blazor 的生命周期管理,埋下 UI 同步隐患。









