Freigeben über


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

Eine Auflistung, die zum Erstellen des Inhalts von ItemsControl verwendet wird. Der Standardwert ist null.

Attribute

Hinweise

Inhaltsmodell: Diese Eigenschaft kann zum Hinzufügen von Elementen zu einem ItemsControlverwendet werden.

Ein häufiges Szenario besteht darin, ein ItemsControl wie ein ListBox- ListViewoder TreeView zum Anzeigen einer Datensammlung oder zum Binden eines ItemsControl an ein Auflistungsobjekt zu verwenden. Verwenden Sie die ItemsSource -Eigenschaft, um ein ItemsControl an ein Auflistungsobjekt zu binden. Beachten Sie, dass die ItemsSource -Eigenschaft die Bindung standardmäßig unterstützt OneWay .

Wenn die ItemsSource -Eigenschaft festgelegt ist, wird die Items Auflistung als schreibgeschützt und mit fester Größe festgelegt.

Wenn ItemsSource sie verwendet wird, entfernt das Festlegen der -Eigenschaft die null Auflistung und stellt die Verwendung auf wieder her, wobei es sich um Itemseine leere ItemCollectionhandelt. Wenn ItemsSource nicht verwendet wird, ist nullder Wert dieser Eigenschaft , und das Festlegen auf null hat keine Auswirkung.

Hinweis

In den meisten Fällen müssen Sie keine eigenen Sammlungen implementieren. Erwägen Sie stattdessen die Verwendung ObservableCollection<T> oder anderer vorhandener Sammlungen. Weitere Informationen finden Sie unter "Sammlungsobjekte, die als Bindungsquelle verwendet werden" unter Ü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: