如何使用CommunityToolkit.Mvvm处理复杂对象类型可观察属性

API 探路者

2026-9-2

处理方式说明

基础用法：直接标注特性即可

[ObservableProperty]特性对属性类型没有任何限制，不管是string、int这类简单类型，还是自定义的POCO复杂对象类型，只要给对应私有字段标注该特性，源生成器就会自动生成带属性变更通知的公共属性，行为和简单类型完全一致。

你示例中的author字段只需要补上特性即可正常使用：

public partial class MyViewModel : ObservableObject
{
   [ObservableProperty]
   string title;

   [ObservableProperty]
   decimal price;

   // Person类型直接标注特性即可，无需额外特殊处理
   [ObservableProperty]
   Person author;
}

完成上述配置后，当你给Author属性整体赋值新的Person实例时，绑定的UI会自动收到变更通知，和Title、Price属性的表现没有区别。

分场景处理内部属性通知

你需要根据实际需求区分两类通知场景，处理逻辑不同：

场景1：仅需要在Author属性被整体替换为新对象时触发通知
直接给author字段加[ObservableProperty]即可，不需要额外配置，和简单类型的用法完全一致。
场景2：需要在Author指向的对象内部属性发生变化时也触发通知
除了给ViewModel中的author字段加特性，还需要让Person类本身继承ObservableObject，其内部需要通知变更的属性同样用[ObservableProperty]标记，示例代码如下：
```
public partial class Person : ObservableObject
{
    [ObservableProperty]
    string name;

    [ObservableProperty]
    int age;
}
```
这种配置下，无论是整体替换Author对象，还是修改Author对象的内部属性，UI都能正常响应更新。