Blazor中组件参数传递主要通过[Parameter]特性实现,要求属性为public且可set;支持简单类型、RenderFragment子内容和EventCallback事件回调,并可设默认值或可空类型。

Blazor 中向组件传递参数主要通过 组件参数(Component Parameters) 实现,本质是给组件的 public 属性打 [Parameter] 特性。这是最常用、最直接的方式。
使用 [Parameter] 传递简单类型参数
在子组件中定义带 [Parameter] 特性的 public 属性,父组件在引用时用属性语法传值:
- 子组件(如
Counter.razor)中写:@code {
[Parameter] public int StartCount { get; set; } = 0;
[Parameter] public string Title { get; set; } = "计数器";
} - 父组件中使用:
- 注意:参数名区分大小写,且必须是 public、可 set 的属性;不加
[Parameter]不会被识别为输入参数。
传递组件内容(Child Content)
用 [Parameter] public RenderFragment ChildContent { get; set; } 接收嵌套内容:
- 子组件(如
Card.razor)中定义:[Parameter] public RenderFragment ChildContent { get; set; } - 模板中渲染:
@ChildContent - 父组件调用:
标题
这里是卡片正文
传递事件回调(EventCallback)
让子组件“通知”父组件,用 EventCallback:
- 子组件中声明:
[Parameter] public EventCallbackOnClick { get; set; } - 触发时调用:
await OnClick.InvokeAsync("按钮被点了"); - 父组件绑定:
并在@code块中定义:private void HandleClick(string msg) { ... }
可选参数与默认值
参数可以设默认值(C# 属性默认值或构造函数初始化),不传也不会报错:
[Parameter] public bool IsEnabled { get; set; } = true;- 也可用
[Parameter] public string? Description { get; set; }表示可为空,不传即为null。 - 若需判断是否显式传入,可用
bool HasValue配合 nullable 引用类型 + 初始化检查,但 Blazor 本身不提供“是否传了”的元信息,一般靠默认值语义区分。
基本上就这些。参数传递不复杂但容易忽略大小写和 public/set 要求,写完记得检查编译错误提示 —— 它通常会明确告诉你哪个属性没加 [Parameter] 或不可访问。









