ItemsControl.ItemsSource Eigenschaft

Definition

Dient zum Abrufen oder Festlegen einer Auflistung, die zum Generieren des Inhalts von ItemsControl verwendet wird.

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. Der Standardwert ist null.

Attribute

Hinweise

Inhaltsmodell: Diese Eigenschaft kann verwendet werden, um Elemente zu einem ItemsControlhinzuzufügen.

Ein gängiges Szenario besteht darin, eine Datensammlung wie ListBoxein ItemsControl , ListViewoder eine Datensammlung anzuzeigen oder TreeView eine ItemsControl Bindung an ein Auflistungsobjekt zu binden. Verwenden Sie die ItemsSource Eigenschaft, um ein ItemsControl Auflistungsobjekt an ein Auflistungsobjekt zu binden. Beachten Sie, dass die Eigenschaft standardmäßig die ItemsSource Bindung unterstützt OneWay .

Wenn die Eigenschaft festgelegt wird, wird die ItemsSource Items Auflistung schreibgeschützt und festgelegt.

Wenn ItemsSource die Eigenschaft verwendet wird, werden null die Auflistung entfernt und die Verwendung Itemswiederhergestellt, die leer ItemCollectionist. Wenn ItemsSource diese Eigenschaft nicht verwendet wird, ist nullder Wert dieser Eigenschaft , und das Festlegen, dass null es keine Auswirkung hat.

Hinweis

In den meisten Fällen müssen Sie Ihre eigenen Sammlungen nicht implementieren. Ziehen Sie stattdessen die Verwendung ObservableCollection<T> oder andere vorhandene Sammlungen in Betracht. Weitere Informationen finden Sie unter "Auflistungsobjekte, die als Bindungsquelle verwendet werden" in der Übersicht über Bindungsquellen.

Verwendung von XAML-Attributen

<object ItemsSource="bindingDeclaration"/>  

XAML-Werte

bindingDeclaration
Eine Binding Deklaration. Weitere Informationen finden Sie unter Binding Markup Extension .

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld ItemsSourceProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für