Blazor中EventCallback命名规范与双向绑定的冲突问题

核心结论：你没有操作错误，这是Blazor针对不同场景的两种命名约定，无需强行统一，区分场景处理即可。 #

1. 两种命名规则的明确边界 #

Blazor的EventCallback命名分两种场景，规则完全不同：

• 单向事件回调（非双向绑定场景）：
  遵循On[EventName]命名，比如：

  [Parameter]
  public EventCallback<CultureInfo> OnCultureChanged { get; set; }
  

  这是Blazor University、官方示例推荐的方式，对齐主流SPA框架的事件命名习惯，适合用于独立的事件通知（比如按钮点击、自定义事件触发）。

• 双向绑定配套回调：
  必须严格遵循[PropertyName]Changed的命名规则，这是Blazor双向绑定的强制约定，不能添加On前缀，比如：

  [Parameter]
  public KartenMode? SelectedKartenMode { get; set; }
  
  [Parameter]
  public EventCallback<KartenMode> SelectedKartenModeChanged { get; set; }
  

  只有这种命名才能让Blazor自动识别@bind-SelectedKartenMode的双向绑定语法，否则只能手动指定@bind-xxx:set，增加代码复杂度。

2. 官方示例的“矛盾”原因 #

官方示例中同时出现两种命名，并非规则冲突，而是场景不同：

• 使用OnXxx的示例，都是单向事件通知场景（比如组件内部触发的自定义事件，不需要关联某个属性的变更）；
• 双向绑定的[PropertyName]Changed命名，是专门为属性联动的双向绑定设计的特殊约定，属于框架的底层机制要求。

3. 最优兼容方案：按场景区分命名 #

无需强行统一两种规则，而是明确区分使用场景：

• 当组件暴露的是独立事件（不需要和组件属性联动）：使用OnXxx命名，保持和其他SPA框架的一致性；
• 当组件暴露的是支持双向绑定的属性：严格遵循[PropertyName]Changed命名，确保双向绑定语法正常工作，同时该回调也可以作为单向事件被外部调用。

避免使用手动指定@bind-xxx:set的繁琐方案，这会破坏代码的可读性和框架约定的一致性，增加后续维护成本。

内容的提问来源于stack exchange，提问作者Matthias Müller