Comment : créer et effectuer une liaison à un ObservableCollection

  • Article

Cet exemple montre comment créer et lier à une collection qui dérive de la ObservableCollection<T> classe, qui est une classe de collection qui fournit des notifications lorsque des éléments sont ajoutés ou supprimés.

Exemple

L’exemple suivant illustre l’implémentation d’une collection NameList :

public class NameList : ObservableCollection<PersonName>  
{  
    public NameList() : base()  
    {  
        Add(new PersonName("Willa", "Cather"));  
        Add(new PersonName("Isak", "Dinesen"));  
        Add(new PersonName("Victor", "Hugo"));  
        Add(new PersonName("Jules", "Verne"));  
    }  
  }  
  
  public class PersonName  
  {  
      private string firstName;  
      private string lastName;  
  
      public PersonName(string first, string last)  
      {  
          this.firstName = first;  
          this.lastName = last;  
      }  
  
      public string FirstName  
      {  
          get { return firstName; }  
          set { firstName = value; }  
      }  
  
      public string LastName  
      {  
          get { return lastName; }  
          set { lastName = value; }  
      }  
  }  

Public Class NameList  
    Inherits ObservableCollection(Of PersonName)  
  
    ' Methods  
    Public Sub New()  
        MyBase.Add(New PersonName("Willa", "Cather"))  
        MyBase.Add(New PersonName("Isak", "Dinesen"))  
        MyBase.Add(New PersonName("Victor", "Hugo"))  
        MyBase.Add(New PersonName("Jules", "Verne"))  
    End Sub  
  
End Class  
  
Public Class PersonName  
    ' Methods  
    Public Sub New(ByVal first As String, ByVal last As String)  
        Me._firstName = first  
        Me._lastName = last  
    End Sub  
  
    ' Properties  
    Public Property FirstName() As String  
        Get  
            Return Me._firstName  
        End Get  
        Set(ByVal value As String)  
            Me._firstName = value  
        End Set  
    End Property  
  
    Public Property LastName() As String  
        Get  
            Return Me._lastName  
        End Get  
        Set(ByVal value As String)  
            Me._lastName = value  
        End Set  
    End Property  
  
    ' Fields  
    Private _firstName As String  
    Private _lastName As String  
End Class

Vous pouvez rendre la collection disponible pour la liaison de la même façon que vous le feriez avec d’autres objets CLR (Common Language Runtime), comme décrit dans Rendre les données disponibles pour la liaison en XAML. Par exemple, vous pouvez instancier la collection en XAML et spécifier la collection en tant que ressource, comme illustré ici :

<Window  
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
  xmlns:c="clr-namespace:SDKSample"  
  x:Class="SDKSample.Window1"  
  Width="400"  
  Height="280"  
  Title="MultiBinding Sample">  
  
  <Window.Resources>  
    <c:NameList x:Key="NameListData"/>  
  
...  
  
</Window.Resources>

Vous pouvez ensuite effectuer une liaison à la collection :

<ListBox Width="200"  
         ItemsSource="{Binding Source={StaticResource NameListData}}"  
         ItemTemplate="{StaticResource NameItemTemplate}"  
         IsSynchronizedWithCurrentItem="True"/>

La définition de NameItemTemplate n’est pas indiquée ici.

Remarque

Les objets de votre collection doivent satisfaire aux conditions décrites dans la Vue d’ensemble des sources de liaison. En particulier, si vous utilisez OneWay ou TwoWay (par exemple, vous souhaitez que votre interface utilisateur soit mise à jour lorsque les propriétés sources changent dynamiquement), vous devez implémenter un mécanisme de notification modifié de propriété approprié tel que l’interface INotifyPropertyChanged .

Pour plus d’informations, consultez la section « Liaisons de collections » de la Vue d’ensemble de la liaison de données.

Voir aussi