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í hodnota 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í typu ItemsControlListBox, nebo ListViewTreeView zobrazení kolekce dat nebo vytvoření vazby ItemsControl k objektu kolekce. K vytvoření vazby objektu ItemsControl kolekce použijte ItemsSource vlastnost. Všimněte si, že ItemsSource vlastnost ve výchozím nastavení podporuje OneWay vazbu.
ItemsSource Při nastavení Items vlastnosti je kolekce určena jen pro čtení a pevná velikost.
Pokud ItemsSource se používá, nastavení vlastnosti pro null odebrání kolekce a obnovení využití do Items, což bude prázdné ItemCollection. Pokud ItemsSource se nepoužívá, hodnota této vlastnosti je nulla nastavení null 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é 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í značek vazeb .
Informace o vlastnosti závislosti
| Položka | Hodnota |
|---|---|
| Pole Identifikátor | ItemsSourceProperty |
Vlastnosti metadat nastavené na true |
None |