ItemsControl.ItemsSource Vlastnost

Definice

Získá nebo nastaví kolekci, která se používá k vygenerování obsahu 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; }
[<System.ComponentModel.Bindable(true)>]
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Hodnota vlastnosti

IEnumerable

Kolekce, která se používá k vygenerování obsahu ItemsControl .A collection that is used to generate the content of the ItemsControl. Výchozí formát je null.The default is null.

Atributy

Poznámky

Model obsahu: Tato vlastnost může být použita k přidání položek do ItemsControl .Content Model: This property may be used to add items to an ItemsControl.

Běžným scénářem je použít ItemsControl například ListBox , ListView nebo TreeView k zobrazení kolekce dat nebo k vytvoření vazby ItemsControl k objektu kolekce.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. Chcete-li vytvořit instanci ItemsControl objektu kolekce, použijte ItemsSource vlastnost.To bind an ItemsControl to a collection object, use the ItemsSource property. Všimněte si, že ItemsSource vlastnost podporuje OneWay ve výchozím nastavení vazbu.Note that the ItemsSource property supports OneWay binding by default.

Když ItemsSource je vlastnost nastavena, Items kolekce je určena jen pro čtení a pevná velikost.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

Pokud ItemsSource je používán, nastavení vlastnosti pro null odebrání kolekce a obnovení využití do Items , což bude prázdné 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. Pokud ItemsSource se nepoužívá, hodnota této vlastnosti je null a její nastavení null nemá žádný vliv.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

Poznámka

Ve většině případů nemusíte implementovat vlastní kolekce.In most cases you do not need to implement your own collections. Místo toho zvažte použití ObservableCollection<T> nebo jiné existující kolekce.Instead, consider using ObservableCollection<T> or other existing collections. Další informace naleznete v tématu "objekty kolekce používané jako zdroj vazby" v tématu Přehled zdrojů vazby.For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

Použití atributu XAMLXAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  

Hodnoty XAMLXAML Values

bindingDeclarationbindingDeclaration
BindingDeklarace.A Binding declaration. Další informace najdete v tématu rozšíření značek vazby .See Binding Markup Extension for more information.

Informace o vlastnosti závislostiDependency Property Information

Pole identifikátoruIdentifier field ItemsSourceProperty
Vlastnosti metadat nastavené na trueMetadata properties set to true ŽádnéNone

Platí pro