ItemsControl.ItemsSource Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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 |