ItemsControl.ItemsSource Свойство

Определение

Возвращает или задает коллекцию, используемую для создания содержимого ItemsControl.Gets or sets a collection used to generate the content of the 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; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

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

Коллекция, которая используется для создания содержимого ItemsControl.A collection that is used to generate the content of the ItemsControl. Значение по умолчанию — null.The default is null.

Атрибуты

Комментарии

Модель содержимого: Это свойство можно использовать для добавления элементов в ItemsControl.Content Model: This property may be used to add items to an ItemsControl.

Распространенный сценарий заключается в использовании ItemsControl, например ListBox, ListViewили TreeView для вывода коллекции данных или привязки ItemsControl к объекту коллекции.A common scenario is to use an ItemsControl such as a ListBox, ListView, or TreeView to display a data collection, or to bind an ItemsControl to a collection object. Чтобы привязать ItemsControl к объекту коллекции, используйте свойство ItemsSource.To bind an ItemsControl to a collection object, use the ItemsSource property. Обратите внимание, что свойство ItemsSource поддерживает привязку OneWay по умолчанию.Note that the ItemsSource property supports OneWay binding by default.

Если задано свойство ItemsSource, Itemsная коллекция становится доступна только для чтения и имеет фиксированный размер.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

Если ItemsSource используется, задание для свойства значения null удаляет коллекцию и восстанавливает использование до Items, что будет пустым ItemCollection.When ItemsSource is in use, setting the property to null removes the collection and restores usage to Items, which will be an empty ItemCollection. Если ItemsSource не используется, значение этого свойства равно nullи задание для него значения null не оказывает никакого влияния.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

Примечание

В большинстве случаев не требуется реализовывать собственные коллекции.In most cases you do not need to implement your own collections. Вместо этого рассмотрите возможность использования ObservableCollection<T> или других существующих коллекций.Instead, consider using ObservableCollection<T> or other existing collections. Дополнительные сведения см. в разделе "объекты коллекции, используемые в качестве источника привязки" раздела Общие сведения об источниках привязки.For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

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

<object ItemsSource="bindingDeclaration"/>  

Значения XAMLXAML Values

биндингдекларатионbindingDeclaration
Объявление Binding.A Binding declaration. Дополнительные сведения см. в разделе Привязка расширения разметки .See Binding Markup Extension for more information.

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

Поле идентификатораIdentifier field ItemsSourceProperty
Для свойств метаданных задано значение trueMetadata properties set to true ОтсутствуютNone

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