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 |
Нет |