Instrukcje: implementowanie powiadomienia o zmianie właściwości

Aby obsługiwać OneWay lub powiązanie TwoWay, aby umożliwić właściwościom docelowym powiązania automatyczne odzwierciedlanie dynamicznych zmian źródła powiązania (na przykład w celu automatycznego zaktualizowania okienka podglądu podczas edytowania formularza przez użytkownika), klasa musi dostarczyć odpowiednie powiadomienia o zmianie właściwości. W tym przykładzie pokazano, jak utworzyć klasę, która implementuje INotifyPropertyChanged.

Przykład

Aby zaimplementować INotifyPropertyChanged należy zadeklarować zdarzenie PropertyChanged i utworzyć metodę OnPropertyChanged. Następnie dla każdej właściwości, dla której chcesz zmienić powiadomienia, należy wywołać OnPropertyChanged za każdym razem, gdy właściwość zostanie zaktualizowana.

C#

using System.ComponentModel;
using System.Runtime.CompilerServices;

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

      // Create the OnPropertyChanged method to raise the event
      // The calling member's name will be used as the parameter.
      protected void OnPropertyChanged([CallerMemberName] string name = null)
      {
          PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
      }
  }
}

Aby dowiedzieć się, jak można użyć klasy Person do obsługi powiązania TwoWay, zobacz Kontrolowanie, kiedy tekst TextBox aktualizuje źródło.

Zobacz też

• Przegląd źródeł wiązania
• omówienie powiązania danych
• tematy poradnikowe