ItemsControl.ItemsSource Eigenschaft

Definition

Dient zum Abrufen oder Festlegen einer Auflistung, die zum Generieren des Inhalts von ItemsControl verwendet wird.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

Eigenschaftswert

IEnumerable

Eine Auflistung, die zum Erstellen des Inhalts von ItemsControl verwendet wird.A collection that is used to generate the content of the ItemsControl. Der Standardwert lautet null.The default is null.

Attribute

Hinweise

Inhalts Modell: Diese Eigenschaft kann verwendet werden, um Elemente zu einem hinzuzufügen ItemsControl .Content Model: This property may be used to add items to an ItemsControl.

Ein häufiges Szenario ist die Verwendung einer ItemsControl ListBox , ListView , oder zum TreeView Anzeigen einer Datensammlung oder das Binden eines an ein Auflistungs ItemsControl Objekt.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. Um einen an ein Auflistungs ItemsControl Objekt zu binden, verwenden Sie die- ItemsSource Eigenschaft.To bind an ItemsControl to a collection object, use the ItemsSource property. Beachten Sie, dass die- ItemsSource Eigenschaft die OneWay Bindung standardmäßig unterstützt.Note that the ItemsSource property supports OneWay binding by default.

Wenn die ItemsSource -Eigenschaft festgelegt ist, wird die-Auflistung schreibgeschützt Items und mit fester Größe festgelegt.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

Wenn ItemsSource verwendet wird, wird durch Festlegen der-Eigenschaft auf null die-Auflistung entfernt und die Verwendung in wieder hergestellt, wobei es sich um Items eine leere handelt 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. Wenn ItemsSource nicht verwendet wird, ist der Wert dieser Eigenschaft null , und das Festlegen von auf null hat keine Auswirkungen.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

Hinweis

In den meisten Fällen müssen Sie keine eigenen Sammlungen implementieren.In most cases you do not need to implement your own collections. Verwenden Sie stattdessen ObservableCollection<T> oder andere vorhandene Sammlungen.Instead, consider using ObservableCollection<T> or other existing collections. Weitere Informationen finden Sie in der Übersicht über Bindungs Quellenunter "Auflistungs Objekte, die als Bindungs Quelle verwendet werden".For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

Verwendung von XAML-AttributenXAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  

XAML-WerteXAML Values

bindingdeclarationbindingDeclaration
Eine- Binding Deklaration.A Binding declaration. Weitere Informationen finden Sie unter Binding Markup Extension .See Binding Markup Extension for more information.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field ItemsSourceProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für: