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

Mise à jour : novembre 2007

Cet exemple montre comment créer et effectuer une liaison à une collection qui dérive de la classe ObservableCollection<T>, qui est une classe de collection fournissant des notifications lors de l'ajout ou de la suppression d'éléments.

Exemple

L'exemple suivant montre l'implémentation d'une collection NameList :

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

Vous pouvez rendre la collection disponible pour la liaison de la même manière que pour les autres objets Common Language Runtime (CLR), comme cela est décrit dans Comment : rendre des 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 cela est illustré comme suit :

<Window
  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://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 lier à la collection :

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

La définition de NameItemTemplate n'est pas affichée ici. Pour l'exemple complet, consultez Implémentation de MultiBinding paramétré, exemple.

Remarque :

Les objets de votre collection doivent répondre aux exigences décrites dans Vue d'ensemble des sources de liaison. En particulier, si vous utilisez OneWay ou TwoWay (par exemple, vous souhaitez que votre interface utilisateur se mette à jour lorsque les propriétés sources changent dynamiquement), vous devez implémenter un mécanisme de notification de modification de propriété adapté comme l'interface INotifyPropertyChanged.

Pour plus d'informations, consultez la section Liaison à des collections dans Vue d'ensemble de la liaison de données.

Voir aussi

Tâches

Affichage des couleurs système à l'aide des services de données, exemple

Liaison à une collection, exemple

Comment : trier des données dans une vue

Comment : filtrer les données d'une vue

Comment : trier et grouper des données à l'aide d'une vue en XAML

Concepts

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