INotifyPropertyChanged Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Benachrichtigt Clients, dass sich ein Eigenschaftswert geändert hat.
.NETTO Diese Schnittstelle wird als System.ComponentModel.INotifyPropertyChanged angezeigt.
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
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
Beim Programmieren mit .NET ist diese Schnittstelle ausgeblendet, und Entwickler sollten die System.ComponentModel.INotifyPropertyChanged-Schnittstelle verwenden.
Die INotifyPropertyChanged-Schnittstelle wird verwendet, um Clients (in der Regel Bindungsclients) darüber zu benachrichtigen, dass sich ein Eigenschaftswert geändert hat. Betrachten Sie beispielsweise ein Employee
-Objekt mit einer Eigenschaft namens Name
. Um eine generische Eigenschaftsänderungsbenachrichtigung bereitzustellen, implementiert der Employee
Typ die INotifyPropertyChanged-Schnittstelle und löst ein PropertyChanged-Ereignis aus, wenn Name
geändert wird.
Das PropertyChanged-Ereignis kann angeben, dass alle Eigenschaften des Objekts mithilfe von String.Empty für die PropertyName-Eigenschaft der PropertyChangedEventArgs geändert wurden. Beachten Sie, dass Sie dafür nicht null (Nothing in Microsoft Visual Basic) wie in Windows Presentation Foundation (WPF) und Microsoft Silverlight verwenden können.
Das PropertyChanged-Ereignis kann angeben, dass sich die Indexereigenschaften für das Objekt mithilfe des PropertyName-Werts "Item[indexer ]" für bestimmte Indexer oder "Item[]" für alle Indexer geändert haben. Beachten Sie, dass C++ derzeit keine Bindung an Indexer unterstützt. Eine Problemumgehung finden Sie im XAML-Datenbindungsbeispiel.
Ereignisse
PropertyChanged |
Tritt ein, wenn sich ein Eigenschaftswert ändert. |