ItemsControl.ItemsSource Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: BindableAttribute

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:

Freigeben über