WPF中INotifyPropertyChanged使用总结

在WPF中，INotifyPropertyChanged（INPC）是实现数据绑定的核心接口，用于通知UI属性值已变更。以下是关键总结：

---

1. 核心作用

• 当ViewModel属性值变化时，自动通知UI更新（无需手动刷新控件）。

• 实现MVVM模式中数据驱动UI的关键机制。

---

2. 基本实现步骤

(1) 实现接口

public class ViewModelBase : INotifyPropertyChanged
{
    public event PropertyChangedEventHandler? PropertyChanged;
    
    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = "")
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

(2) 属性封装

public class UserViewModel : ViewModelBase
{
    private string _name;
    public string Name
    {
        get => _name;
        set
        {
            if (_name != value)
            {
                _name = value;
                OnPropertyChanged(); // 自动传递调用者属性名
            }
        }
    }
}

---

3. 优化技巧

(1) 使用 [CallerMemberName]

• 避免硬编码属性名，编译器自动填充调用属性的名称：

  OnPropertyChanged(); // 无需参数

(2) 封装SetField方法

• 减少重复代码，支持值比较：

  protected bool SetField<T>(ref T field, T value, [CallerMemberName] string propertyName = "")
  {
      if (EqualityComparer<T>.Default.Equals(field, value)) 
          return false;
      
      field = value;
      OnPropertyChanged(propertyName);
      return true;
  }
  
  // 使用示例
  public string Name
  {
      get => _name;
      set => SetField(ref _name, value);
  }

(3) 批量更新属性

• 同时通知多个属性变更：

  public void UpdateAll()
  {
      OnPropertyChanged(nameof(Property1));
      OnPropertyChanged(nameof(Property2));
      // 或
      OnPropertyChanged(string.Empty); // 通知所有绑定属性（谨慎使用）
  }

---

4. 线程安全

• 在非UI线程更新属性时，需调度到UI线程：

  protected void OnPropertyChanged(string propertyName)
  {
      if (Application.Current.Dispatcher.CheckAccess())
          PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
      else
          Application.Current.Dispatcher.Invoke(() => 
              PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)));
  }

---

5. 常见错误

• 忘记触发通知：属性赋值后未调用OnPropertyChanged。

• 拼写错误：手动传入字符串时属性名错误（推荐用nameof或[CallerMemberName]）。

• 无值检查：未比较新旧值导致不必要的UI刷新。

---

6. 高级方案

(1) 使用Fody.PropertyChanged

• 通过IL注入自动实现INPC，无需手写代码：

  [AddINotifyPropertyChangedInterface]
  public class UserViewModel
  {
      public string Name { get; set; } // 自动注入通知代码
  }

(2) 继承ObservableObject（CommunityToolkit.Mvvm）

• 使用现成实现：

  using CommunityToolkit.Mvvm.ComponentModel;
  
  public partial class UserViewModel : ObservableObject
  {
      [ObservableProperty]
      private string _name; // 自动生成 public string Name { ... }
  }

---

7. 性能注意

• 避免在循环中频繁触发通知（可批量更新）。

• 复杂对象属性变更时，考虑手动通知（如集合元素变化需ObservableCollection）。

---

总结

场景	推荐做法
基础实现	封装SetField + [CallerMemberName]
简化代码	使用Fody或CommunityToolkit.Mvvm
跨线程更新	通过Dispatcher.Invoke调度
批量更新	调用多次OnPropertyChanged或通知空字符串

最佳实践：优先使用CommunityToolkit.Mvvm或Fody，减少模板代码，提升开发效率。手动实现时务必封装SetField方法确保健壮性。