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, 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 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 null
der 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 |