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可以使用 或 String.Empty 做為 中的PropertyChangedEventArgs屬性名稱，來指出物件上的所有屬性都已變更null。 請注意，在 UWP 應用程式中， String.Empty 必須使用 ，而不是 null。

適用於

另請參閱

• PropertyChangedEventArgs