Gewusst wie: Implementieren von Benachrichtigungen bei Eigenschaftenänderungen

Aktualisiert: November 2007

Um die OneWay-Bindung oder die TwoWay-Bindung zu unterstützen, um die Bindungsziel-Eigenschaften zu aktivieren, um automatisch die dynamischen Änderungen der Bindungsquelle widerzuspiegeln (z. B. zur automatischen Aktualisierung des Vorschaubereichs, wenn der Benutzer ein Formular bearbeitet), muss die Klasse die passenden Benachrichtigungen bei Eigenschaftenänderungen bereitstellen. In diesem Beispiel wird die Erstellung einer Klasse veranschaulicht, die INotifyPropertyChanged implementiert.

Beispiel

Um INotifyPropertyChanged zu implementieren, müssen Sie das PropertyChanged-Ereignis deklarieren und die OnPropertyChanged-Methode erstellen. Dann rufen Sie für jede Eigenschaft, für die Sie Änderungsbenachrichtigungen erhalten möchten, OnPropertyChanged auf, wenn die Eigenschaft aktualisiert wird.

Imports System.ComponentModel

' This class implements INotifyPropertyChanged
' to support one-way and two-way bindings
' (such that the UI element updates when the source
' has been changed dynamically)
Public Class Person
    Implements INotifyPropertyChanged

    Private personName As String

    Sub New()
    End Sub

    Sub New(ByVal Name As String)
        Me.personName = Name
    End Sub

    ' Declare the event
    Public Event PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged

    Public Property Name() As String
        Get
            Return personName
        End Get
        Set(ByVal value As String)
            personName = value
            ' Call OnPropertyChanged whenever the property is updated
            OnPropertyChanged("Name")
        End Set
    End Property

    ' Create the OnPropertyChanged method to raise the event
    Protected Sub OnPropertyChanged(ByVal name As String)
        RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs(name))
    End Sub

End Class

using System.ComponentModel;

namespace SDKSample
{
  // This class implements INotifyPropertyChanged
  // to support one-way and two-way bindings
  // (such that the UI element updates when the source
  // has been changed dynamically)
  public class Person : INotifyPropertyChanged
  {
      private string name;
      // Declare the event
      public event PropertyChangedEventHandler PropertyChanged;

      public Person()
      {
      }

      public Person(string value)
      {
          this.name = value;
      }

      public string PersonName
      {
          get { return name; }
          set
          {
              name = value;
              // Call OnPropertyChanged whenever the property is updated
              OnPropertyChanged("PersonName");
          }
      }

      // Create the OnPropertyChanged method to raise the event
      protected void OnPropertyChanged(string name)
      {
          PropertyChangedEventHandler handler = PropertyChanged;
          if (handler != null)
          {
              handler(this, new PropertyChangedEventArgs(name));
          }
      }
  }
}

Ein Beispiel für die Verwendung der Person-Klasse zur Unterstützung der TwoWay-Bindung finden Sie unter Gewusst wie: Steuern, wann der TextBox-Text die Quelle aktualisiert.

Das vollständige Beispiel finden Sie unter Beispiel zu einfachen Bindungen.

Siehe auch

Konzepte

Übersicht über Bindungsquellen

Übersicht über Datenbindung

Weitere Ressourcen

Beispiel zur Datenbindung

Gewusst-wie-Themen zur Datenbindung