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 такого типа, как ListBoxListView, или TreeView для отображения коллекции данных или привязки ItemsControl объекта коллекции. Чтобы привязать ItemsControl объект коллекции к объекту ItemsSource коллекции, используйте свойство. Обратите внимание, что ItemsSource свойство поддерживает OneWay привязку по умолчанию.

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

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

Замечание

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

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

<object ItemsSource="bindingDeclaration"/>

Значения XAML

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

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

Элемент Ценность
Поле идентификатора ItemsSourceProperty
Свойства метаданных, равные свойству true Нет

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