ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource Property

Definition

Ruft eine Auflistung ab, mit der der Inhalt des ItemsControl generiert wird, oder legt diese fest.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; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Eigenschaftswert

Eine Auflistung, mit der der Inhalt des ItemsControl generiert wird.A collection that is used to generate the content of the ItemsControl. Die Standardeinstellung ist null.The default is null.

Hinweise

Inhaltsmodell: Diese Eigenschaft kann verwendet werden, um das Hinzufügen von Elementen zu einer ItemsControl.Content Model: This property may be used to add items to an ItemsControl.

Ein häufiges Szenario ist die Verwendung einer ItemsControl wie z. B. eine ListBox, ListView, oder TreeView um eine datenauflistung anzuzeigen oder zu binden ein ItemsControl an ein Auflistungsobjekt.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. Binden einer ItemsControl verwenden, um ein Auflistungsobjekt, das ItemsSource Eigenschaft.To bind an ItemsControl to a collection object, use the ItemsSource property. Beachten Sie, dass die ItemsSource Eigenschaft unterstützt OneWay standardmäßig binden.Note that the ItemsSource property supports OneWay binding by default.

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

Bei der ItemsSource verwendet wird, Festlegen der Eigenschaft auf null die Auflistung entfernt, und wieder her mit Items, die eine leere sein 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 ist nicht in Gebrauch, der Wert dieser Eigenschaft ist null, und wenn diese Option 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 nicht Ihre eigenen Auflistungen implementieren.In most cases you do not need to implement your own collections. Verwenden Sie stattdessen ObservableCollection<T> oder anderen vorhandenen Sammlungen.Instead, consider using ObservableCollection<T> or other existing collections. Weitere Informationen finden Sie unter "Verwenden von Auflistungsobjekten als Bindungsquelle" in Übersicht über Bindungsquellen.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
Ein Binding Deklaration.A Binding declaration. Finden Sie unter Binding als Markuperweiterung für Weitere Informationen.See Binding Markup Extension for more information.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field ItemsSourceProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Gilt für: