Практическое руководство. Реализация уведомления об изменении свойства

Обновлен: Ноябрь 2007

Для поддержки привязок OneWay или TwoWay, чтобы позволить вашим свойствам источника привязки автоматически отражать динамические изменения источника привязки (например, провести предварительный просмотр области, автоматически обновляемой, когда пользователь редактирует форму), классу необходимо предоставить соответствующие уведомления об изменении свойств. В этом примере демонстрируется создание класса, который реализует INotifyPropertyChanged.

Пример

Для реализации INotifyPropertyChanged необходимо объявить событие PropertyChanged и создать метод OnPropertyChanged. Затем для каждого свойства вам потребуются уведомления об изменениях, поэтому вы вызываете OnPropertyChanged при каждом обновлении свойства.

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));
          }
      }
  }
}

Пример того, как класс Person может использоваться для поддержки привязки TwoWay, см. в разделе Практическое руководство. Управление обновлением источника из поля TextBox.

Полный пример см. в разделе Простой пример привязки.

См. также

Основные понятия

Общие сведения об источниках привязки

Общие сведения о связывании данных

Другие ресурсы

Примеры привязки данных

Практические руководства по привязке данных