INotifyPropertyChanged.PropertyChanged 事件

定义

命名空间:

System.ComponentModel

程序集:

System.ObjectModel.dll

在属性值更改时发生。

C#

event System.ComponentModel.PropertyChangedEventHandler? PropertyChanged;

事件类型

PropertyChangedEventHandler

示例

下面的代码示例演示如何实现 PropertyChanged 接口的 INotifyPropertyChanged 事件。

C#

// This is a simple customer class that 
// implements the IPropertyChange interface.
public class DemoCustomer : INotifyPropertyChanged
{
    // These fields hold the values for the public properties.
    private Guid idValue = Guid.NewGuid();
    private string customerNameValue = string.Empty;
    private string phoneNumberValue = string.Empty;

    public event PropertyChangedEventHandler PropertyChanged;

    // This method is called by the Set accessor of each property.
    // The CallerMemberName attribute that is applied to the optional propertyName
    // parameter causes the property name of the caller to be substituted as an argument.
    private void NotifyPropertyChanged([CallerMemberName] string propertyName = "")
    {
        if (PropertyChanged != null)
        {
            PropertyChanged(this, new PropertyChangedEventArgs(propertyName));
        }
    }

    // The constructor is private to enforce the factory pattern.
    private DemoCustomer()
    {
        customerNameValue = "Customer";
        phoneNumberValue = "(312)555-0100";
    }

    // This is the public factory method.
    public static DemoCustomer CreateNewCustomer()
    {
        return new DemoCustomer();
    }

    // This property represents an ID, suitable
    // for use as a primary key in a database.
    public Guid ID
    {
        get
        {
            return this.idValue;
        }
    }

    public string CustomerName
    {
        get
        {
            return this.customerNameValue;
        }

        set
        {
            if (value != this.customerNameValue)
            {
                this.customerNameValue = value;
                NotifyPropertyChanged();
            }
        }
    }

    public string PhoneNumber
    {
        get
        {
            return this.phoneNumberValue;
        }

        set
        {
            if (value != this.phoneNumberValue)
            {
                this.phoneNumberValue = value;
                NotifyPropertyChanged();
            }
        }
    }
}

注解

事件 PropertyChanged 可以通过使用 null 或 String.Empty 作为 中的 PropertyChangedEventArgs属性名称来指示对象上的所有属性都已更改。 请注意，在 UWP 应用程序中， String.Empty 必须使用 而不是 null。

适用于

另请参阅

• PropertyChangedEventArgs