Comment : implémenter la notification des modifications de propriétés

Mise à jour : novembre 2007

Pour prendre en charge la liaison OneWay ou TwoWay permettant à vos propriétés de cible de liaison de refléter automatiquement les modifications dynamiques de la source de liaison (par exemple, avoir le volet d'aperçu mis à jour automatiquement lorsque l'utilisateur modifie un formulaire), votre classe doit fournir les notifications de modification de propriété appropriées. Cet exemple indique comment créer une classe qui implémente INotifyPropertyChanged.

Exemple

Pour implémenter INotifyPropertyChanged, vous devez déclarer l'événement PropertyChanged et créer la méthode OnPropertyChanged. Puis, pour chaque propriété pour laquelle vous souhaitez obtenir des notifications de modification, vous appelez OnPropertyChanged à chaque fois que la propriété est mise à jour.

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

Pour consulter un exemple montrant comment la classe Person peut être utilisée pour prendre en charge la liaison TwoWay, consultez Comment : contrôler quand le texte TextBox met à jour la source.

Pour l'exemple complet, consultez Liaison simple, exemple.

Voir aussi

Concepts

Vue d'ensemble des sources de liaison

Vue d'ensemble de la liaison de données

Autres ressources

Exemples de liaisons de données

Rubriques Comment relatives aux liaisons de données