Partilhar via

Como Criar e Ligar a uma ObservableCollection

  • Artigo

Este exemplo mostra como criar e vincular a uma coleção que deriva da classe ObservableCollection<T>, que é uma classe de coleção que fornece notificações quando itens são adicionados ou removidos.

Exemplo

O exemplo a seguir mostra a implementação de uma coleção 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

Você pode disponibilizar a coleção para vinculação da mesma forma que faria com outros objetos CLR (Common Language Runtime), conforme descrito em Disponibilizar dados para vinculação em XAML. Por exemplo, você pode instanciar a coleção em XAML e especificar a coleção como um recurso, conforme mostrado aqui:

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

Em seguida, você pode vincular à coleção:

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

A definição de NameItemTemplate não é mostrada aqui.

Observação

Os objetos em sua coleção devem atender aos requisitos descritos no Binding Sources Overview. Em particular, se você estiver usando OneWay ou TwoWay (por exemplo, você deseja que sua interface do usuário seja atualizada quando as propriedades de origem forem alteradas dinamicamente), deverá implementar um mecanismo de notificação de alteração de propriedade adequado, como a interface INotifyPropertyChanged.

Para obter mais informações, consulte a seção Vinculação a coleções no Visão geral da vinculação de dados.

Ver também