Share via

Практическое руководство. Создание и привязка коллекции "ObservableCollection"

  • Статья

В этом примере демонстрируется создание и привязка коллекции, производной от класса ObservableCollection<T>, который является классом коллекции, предоставляющим уведомления при добавлении или удалении элементов.

Пример

В следующем примере показана реализация коллекции 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; }
      }
  }

Можно сделать коллекцию доступной для привязки тем же способом, который используется для привязки других объектов common language runtime (CLR), как описано в разделе Практическое руководство. Обеспечение доступности данных для привязки в XAML. Например, можно создать экземпляр коллекции в XAML и указать коллекцию в качестве ресурса, как показано ниже:


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

Затем можно выполнить привязку к коллекции:

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

Определение NameItemTemplate здесь не показано.

ПримечаниеПримечание

Объекты в коллекции должны удовлетворять требованиям, описанным в разделе Общие сведения об источниках привязки.В частности, при использовании свойства OneWay или TwoWay (например, в случае необходимости обновлять UI при динамическом изменении свойств источника) необходимо реализовать подходящий механизм уведомления об изменении свойства, такой как интерфейс INotifyPropertyChanged.

Дополнительные сведения см. в подразделе «Привязка к коллекции» раздела Общие сведения о связывании данных.

См. также

Задачи

Практическое руководство. Сортировка данных в представлении

Практическое руководство. Фильтрация данных в представлении

Практическое руководство. Сортировка и группировка данных с помощью представления в XAML

Основные понятия

Общие сведения о связывании данных

Другие ресурсы

Практические руководства по привязке данных