【WPF】 数据绑定机制之INotifyPropertyChanged

INotifyPropertyChanged 是 WPF 中的一个接口,用于实现 数据绑定 中的 属性更改通知。它的主要作用是,当对象的某个属性值发生更改时,通知绑定到该属性的 UI 控件更新其显示内容。

以下是有关 INotifyPropertyChanged 的详细信息和实现方法:


1. INotifyPropertyChanged 简介

INotifyPropertyChanged 定义在 System.ComponentModel 命名空间中,它只包含一个事件:

复制代码
public interface INotifyPropertyChanged
{
    event PropertyChangedEventHandler PropertyChanged;
}
核心机制
  • PropertyChanged 是事件,当对象的属性发生更改时,触发此事件。
  • WPF 数据绑定引擎会监听这个事件,并根据通知更新 UI。

2. 使用场景

在 MVVM 模式中,INotifyPropertyChanged 通常用于 ViewModel 层,确保当属性值更改时,UI 会自动更新。


3. 实现步骤

Step 1: 实现接口
复制代码
using System.ComponentModel;

public class Person : INotifyPropertyChanged
{
    // 实现 INotifyPropertyChanged 接口
    public event PropertyChangedEventHandler PropertyChanged;

    // 用于触发 PropertyChanged 事件的方法
    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    private string name;
    public string Name
    {
        get => name;
        set
        {
            if (name != value)
            {
                name = value;
                // 通知绑定 Name 的 UI 更新
                OnPropertyChanged(nameof(Name));
            }
        }
    }
}
Step 2: 在 XAML 中绑定

创建一个简单的 WPF 界面,绑定到 PersonName 属性。

XAML

复制代码
<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="INotifyPropertyChanged Example" Height="200" Width="300">
    <StackPanel>
        <TextBox Text="{Binding Name, UpdateSourceTrigger=PropertyChanged}" Margin="10"/>
        <TextBlock Text="{Binding Name}" Margin="10"/>
    </StackPanel>
</Window>
Step 3: 设置 DataContext

MainWindow.xaml.cs 中,将 DataContext 设置为 Person 对象。

复制代码
using System.Windows;

namespace WpfApp
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();

            // 创建 Person 对象并绑定到窗口
            DataContext = new Person { Name = "John Doe" };
        }
    }
}

4. 运行效果

  1. TextBox 中修改 Name 的值时,TextBlock 会自动更新为新的值。
  2. 数据绑定引擎通过 INotifyPropertyChanged 的通知机制感知到属性的更改,并更新绑定的 UI。

5. 注意事项

  1. 避免直接使用字符串 : 使用 nameof 操作符替代硬编码的字符串,避免因属性名变更导致的问题。

    复制代码
    OnPropertyChanged(nameof(Name));
  2. 批量更新 : 如果多个属性发生更改,可以调用 OnPropertyChanged(null)OnPropertyChanged(string.Empty),通知所有属性值发生变化。

  3. 多属性通知 : 如果一个属性的更改会影响其他属性,可以触发多个 OnPropertyChanged 调用。

    复制代码
    OnPropertyChanged(nameof(Name));
    OnPropertyChanged(nameof(FullName));

6. 使用封装提高代码复用性

可以将 INotifyPropertyChanged 的逻辑封装到基类中,减少重复代码:

复制代码
public class ObservableObject : INotifyPropertyChanged
{
    public event PropertyChangedEventHandler PropertyChanged;

    protected void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }

    protected bool SetProperty<T>(ref T field, T value, string propertyName)
    {
        if (!Equals(field, value))
        {
            field = value;
            OnPropertyChanged(propertyName);
            return true;
        }
        return false;
    }
}

子类实现

复制代码
public class Person : ObservableObject
{
    private string name;
    public string Name
    {
        get => name;
        set => SetProperty(ref name, value, nameof(Name));
    }
}

7. WPF MVVM Toolkit 实现的 INotifyPropertyChanged

WPF MVVM Toolkit(Microsoft.Toolkit.Mvvm)是 Microsoft 推出的 MVVM 框架,它在 INotifyPropertyChanged 的基础上进行了封装和简化。以下是它的特点和实现:

主要特点
  1. 提供了 ObservableObject 基类,简化了 INotifyPropertyChanged 的实现。
  2. 提供了 SetProperty 方法,避免手动触发 PropertyChanged
  3. 支持属性变更通知的自动化和高效实现。
cs 复制代码
using CommunityToolkit.Mvvm.ComponentModel;

public class Person : ObservableObject
{
    private string name;

    public string Name
    {
        get => name;
        set => SetProperty(ref name, value);
    }
}

在实现 INotifyPropertyChanged 接口时,OnPropertyChanged 方法是开发者定义的用于触发属性变更通知的辅助方法 。当某个属性的值发生变化时,通常由属性的 set 访问器 调用 OnPropertyChanged 方法,从而触发 PropertyChanged 事件。


触发过程

  1. 属性的 set 访问器检测到值发生了变化。

  2. 调用 OnPropertyChanged 方法。

  3. OnPropertyChanged 方法触发 PropertyChanged 事件。

  4. WPF 或其他数据绑定框架监听到 PropertyChanged 事件后,更新绑定到该属性的 UI。

  5. Event PropertyChangedEventHandler 用函数包裹起来触发

  6. 实际中用框架,比如Microsoft.Toolkit.Mvvm, 提供了 ObservableObject 基类,简化了 INotifyPropertyChanged 的实现

相关推荐
The Future is mine1 小时前
C# new Bitmap(32043, 32043, PixelFormat.Format32bppArgb)报错:参数无效,如何将图像分块化处理?
开发语言·c#
Iotfsd8 小时前
.NET写的开源工业物联网网关(IoTGateway)
物联网·c#·.net·dotnet·边缘网关·雾计算·工业物联网智能网关
先生沉默先8 小时前
c#接口_抽象类_多态学习
开发语言·学习·c#
江沉晚呤时9 小时前
深入了解C# List集合及两种常见排序算法:插入排序与堆排序
windows·sql·算法·oracle·c#·排序算法·mybatis
iReachers9 小时前
使用命令行加密混淆C#程序
开发语言·c#
[太阳]889 小时前
Kafka命令行的使用/Spark-Streaming核心编程(二)
c#·linq
电商api接口开发1 天前
ASP.NET MVC 入门指南
c#·asp.net·mvc
我不是程序猿儿1 天前
[C#]反射的实战应用,实际数据模拟
开发语言·c#
爱编程的鱼1 天前
C# 结构(Struct)
开发语言·人工智能·算法·c#
是阿根1 天前
unity使用iTextSharp生成PDF文件
unity·c#·游戏引擎