ItemsControl.ItemsSource Egenskap

Definition

Hämtar eller anger en samling som används för att generera innehållet i ItemsControl.

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

Egenskapsvärde

En samling som används för att generera innehållet i ItemsControl. Standardvärdet är null.

Attribut

Kommentarer

Innehållsmodell: Den här egenskapen kan användas för att lägga till objekt i en ItemsControl.

Ett vanligt scenario är att använda en ItemsControl till exempel , ListBoxListView, eller TreeView för att visa en datainsamling eller binda en ItemsControl till ett samlingsobjekt. Om du vill binda ett ItemsControl till ett samlingsobjekt använder du egenskapen ItemsSource . Observera att egenskapen ItemsSource stöder OneWay bindning som standard.

När egenskapen ItemsSource har angetts Items görs samlingen skrivskyddad och fast storlek.

När ItemsSource används, anger du egenskapen så att null den tar bort samlingen och återställer användningen till Items, som blir en tom ItemCollection. När ItemsSource används inte är nullvärdet för den här egenskapen , och inställningen null har ingen effekt.

Note

I de flesta fall behöver du inte implementera dina egna samlingar. Överväg i stället att använda ObservableCollection<T> eller andra befintliga samlingar. Mer information finns i "Samlingsobjekt som används som bindningskälla" i Översikt över bindningskällor.

XAML-attributanvändning

<object ItemsSource="bindingDeclaration"/>

XAML-värden

bindingDeclaration En Binding deklaration. Mer information finns i Bindningsmarkeringstillägg .

Information om beroendeegenskap

Objekt Value
Identifierarfält ItemsSourceProperty
Metadataegenskaper inställda på true Ingen

Gäller för