ItemsControl.ItemsSource Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví kolekci použitou k vygenerování obsahu 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á k vygenerování obsahu 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 je použitíItemsControl, jako ListBoxje například , nebo ListViewTreeView zobrazení kolekce dat nebo vytvoření vazby ItemsControl k objektu kolekce. Chcete-li vytvořit vazbu ItemsControl k objektu kolekce, použijte ItemsSource vlastnost. Všimněte si, že ItemsSource vlastnost ve výchozím nastavení podporuje OneWay vazbu.
ItemsSource Když je vlastnost nastavena, Items kolekce se vytvoří jen pro čtení a pevnou velikost.
Při ItemsSource použití nastavení vlastnosti odebere null
kolekci a obnoví využití do Items, což bude prázdné ItemCollection. Pokud ItemsSource se nepoužívá, hodnota této vlastnosti je null
a nastavení nemá null
žá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é existující kolekce. Další informace najdete v tématu "Objekty kolekce používané 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í vazeb značek .
Informace o vlastnosti závislosti
Pole identifikátoru | ItemsSourceProperty |
Vlastnosti metadat nastavené na true |
Žádné |