Blazor双向绑定不一致：替换类实例未触发更新问题咨询

问题现象 #

在Blazor开发中，将类作为双向绑定参数传递时，直接替换整个类实例不会触发双向绑定，父组件中的实例不会更新；但逐个更新类的属性时，父组件的实例会同步更新。

父组件代码

<DataSourceDatabase @bind-DataSource="@DataSource"
                    IsComponentDisabled="false">
</DataSourceDatabase>

子组件参数定义

partial class DataSourceDatabase
{
    [Parameter] public DataSourceModel DataSource { get; set; } = new();
    [Parameter] public EventCallback<DataSourceModel> DataSourceChanged { get; set; } 
}

不生效的写法（替换整个实例）

var validateResponse = await PipelineServer.ValidateSource(request);
if (validateResponse.Success)
{
   DataSource = validateResponse.Data;
}

生效的写法（修改属性）

var validateResponse = await PipelineServer.ValidateSource(request);
if (validateResponse.Success)
{
   DataSource.DefaultSchema = validateResponse.Data.DefaultSchema;
   // ...其他属性赋值
}

原因解析 #

Blazor的@bind-XXX双向绑定是语法糖，本质是单向参数传递+XXXChanged回调通知：

• 直接替换子组件的DataSource实例时，仅修改了子组件内部的参数引用，但未触发DataSourceChanged回调，父组件无法感知到变化，因此不会更新自身的DataSource实例。
• 修改属性时，由于父组件和子组件引用的是同一个DataSourceModel实例，属性变更会直接反映到父组件的实例上——这是引用类型的特性，并非Blazor双向绑定机制的直接作用，这种方式存在隐患：若父组件后续重新渲染，可能会将子组件的DataSource参数覆盖回原有值。

正确解决方案 #

无论替换整个实例还是修改属性，都应通过DataSourceChanged回调通知父组件更新，这是Blazor双向绑定的标准用法：

替换整个实例时

var validateResponse = await PipelineServer.ValidateSource(request);
if (validateResponse.Success)
{
   await DataSourceChanged.InvokeAsync(validateResponse.Data);
}

调用回调后，父组件的DataSource会被更新为新实例，同时子组件的DataSource参数会随父组件的更新同步。

修改属性时（推荐写法）

var validateResponse = await PipelineServer.ValidateSource(request);
if (validateResponse.Success)
{
   // 修改现有实例的属性
   DataSource.DefaultSchema = validateResponse.Data.DefaultSchema;
   // ...其他属性赋值
   // 通知父组件更新
   await DataSourceChanged.InvokeAsync(DataSource);
}

通过回调确保父组件感知到实例变化，避免潜在的状态不一致问题。

总结 #

这是Blazor双向绑定的正常机制，你并未遗漏知识点。引用类型的属性修改因实例共享会直接同步到父组件，但替换实例必须通过Changed回调触发父组件更新。此内容可帮助其他开发者避免同类踩坑。

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