ItemsControl.ItemsSource Vlastnost

Definice

Získá nebo nastaví kolekci použitou ke generování obsahu objektu 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

Hodnota vlastnosti

Kolekce, která se používá ke generování obsahu objektu ItemsControl. Výchozí formát je null.

Atributy

Poznámky

Model obsahu: Tuto vlastnost lze použít k přidání položek do objektu ItemsControl.

Běžným scénářem ItemsControl je použití například ListBox, ListViewnebo TreeView k zobrazení kolekce dat nebo vytvoření vazby objektu ItemsControl s objektem kolekce. Pokud chcete vytvořit vazbu s ItemsControl objektem kolekce, použijte ItemsSource vlastnost . Všimněte si ItemsSource , že vlastnost ve výchozím nastavení podporuje OneWay vazbu.

ItemsSource Když je vlastnost nastavena, Items kolekce se nastaví jen pro čtení a pevnou velikost.

Když ItemsSource se používá, nastavení vlastnosti na null odebrání kolekce a obnovení využití do Items, který bude prázdný ItemCollection. Pokud ItemsSource se nepoužívá, hodnota této vlastnosti je nulla nastavení null této vlastnosti nemá žádný vliv.

Poznámka

Ve většině případů nemusíte implementovat vlastní kolekce. Místo toho zvažte použití ObservableCollection<T> nebo jiných existujících kolekcí. Další informace najdete v tématu "Objekty kolekce použité jako zdroj vazby" v přehledu zdrojů vazeb.

Použití atributu XAML

<object ItemsSource="bindingDeclaration"/>

Hodnoty XAML

bindingDeclaration Deklarace Binding . Další informace najdete v tématu Rozšíření značek vazby .

Informace o vlastnosti závislosti

Pole Identifikátor ItemsSourceProperty
Vlastnosti metadat nastavené na true Žádné

Platí pro