ItemsControl.ItemsSource Свойство

Определение

Возвращает или задает коллекцию, используемую для создания содержимого ItemsControl.

public:
 property System::Collections::IEnumerable ^ ItemsSource { System::Collections::IEnumerable ^ get(); void set(System::Collections::IEnumerable ^ value); };
[System.ComponentModel.Bindable(true)]
public System.Collections.IEnumerable ItemsSource { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Значение свойства

Коллекция, которая используется для создания содержимого ItemsControl. Значение по умолчанию — null.

Атрибуты

Комментарии

Модель содержимого: Это свойство может использоваться для добавления элементов в .ItemsControl

Распространенным сценарием является использование ItemsControl , например ListBox, ListViewили TreeView , для отображения коллекции данных или привязки ItemsControl к объекту коллекции. Чтобы привязать ItemsControl к объекту коллекции, используйте ItemsSource свойство . Обратите внимание, что ItemsSource свойство поддерживает OneWay привязку по умолчанию.

ItemsSource Если свойство задано, коллекция становится доступной Items только для чтения и фиксированного размера.

Если ItemsSource используется, присвойте свойству значение , чтобы null удалить коллекцию и восстановить использование в Itemsзначение , которое будет пустым ItemCollection. Если ItemsSource свойство не используется, значение этого свойства равно null, и установка ему null значения не оказывает никакого влияния.

Примечание

В большинстве случаев вам не нужно реализовывать собственные коллекции. Вместо этого рассмотрите возможность использования ObservableCollection<T> или других существующих коллекций. Дополнительные сведения см. в разделе "Объекты коллекции, используемые в качестве источника привязки" статьи Обзор источников привязки.

Использование атрибута XAML

<object ItemsSource="bindingDeclaration"/>

Значения XAML

bindingDeclaration Объявление Binding . Дополнительные сведения см. в разделе Расширение разметки привязки .

Сведения о свойстве зависимостей

Поле идентификатора ItemsSourceProperty
Для свойств метаданных задано значение true Нет

Применяется к