ItemsControl.ItemsSource Eigenschaft
Definition
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, setPublic Property ItemsSource As IEnumerableEigenschaftswert
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 |
