INotifyPropertyChanged Interface

Definition

Notifies clients that a property value has changed.

.NET This interface appears as System.ComponentModel.INotifyPropertyChanged.

public interface class INotifyPropertyChanged
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3480606364, 62196, 18539, 179, 2, 187, 76, 9, 186, 235, 250)]
struct INotifyPropertyChanged
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3480606364, 62196, 18539, 179, 2, 187, 76, 9, 186, 235, 250)]
public interface INotifyPropertyChanged
Public Interface INotifyPropertyChanged
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

When programming with .NET, this interface is hidden and developers should use the System.ComponentModel.INotifyPropertyChanged interface.

The INotifyPropertyChanged interface is used to notify clients, typically binding clients, that a property value has changed. For example, consider an Employee object with a property called Name. To provide generic property-change notification, the Employee type implements the INotifyPropertyChanged interface and raises a PropertyChanged event when Name is changed.

The PropertyChanged event can indicate that all properties on the object have changed by using String.Empty for the PropertyName property of the PropertyChangedEventArgs. Note that you cannot use null (Nothing in Microsoft Visual Basic) for this like you can in Windows Presentation Foundation (WPF) and Microsoft Silverlight.

The PropertyChanged event can indicate that indexer properties on the object have changed by using a PropertyName value of "Item[indexer ]" for specific indexers or "Item[]" for all indexers. Note that C++ does not currently support binding to indexers. For a workaround, see the XAML data binding sample.

Events

PropertyChanged

Occurs when a property value changes.

Applies to

See also