ItemsControl.ItemsSource Proprietà

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ottiene o imposta una raccolta usata per generare il contenuto dell'oggetto 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

Valore della proprietà

IEnumerable

Raccolta usata per generare il contenuto dell'oggetto ItemsControl. Il valore predefinito è null.

Attributi

BindableAttribute

Commenti

Modello di contenuto: Questa proprietà può essere usata per aggiungere elementi a un ItemsControloggetto .

Uno scenario comune consiste nell'usare un ItemsControlListBoxoggetto, ad esempio , ListViewo TreeView per visualizzare una raccolta dati o associare un oggetto ItemsControl a un insieme. Per associare un oggetto ItemsControl a un insieme, usare la ItemsSource proprietà . Si noti che la proprietà supporta OneWay l'associazione ItemsSource per impostazione predefinita.

Quando la proprietà è impostata, la ItemsSourceItems raccolta viene resa di sola lettura e dimensione fissa.

Quando ItemsSource è in uso, impostando la proprietà per null rimuovere l'utilizzo della raccolta e ripristina l'utilizzo su Items, che sarà un oggetto vuoto ItemCollection. Quando ItemsSource non è in uso, il valore di questa proprietà è nulle impostandolo su null non ha alcun effetto.

Nota

Nella maggior parte dei casi non è necessario implementare le proprie raccolte. Prendere invece in considerazione l'uso ObservableCollection<T> o altre raccolte esistenti. Per altre informazioni, vedere la sezione "Oggetti raccolta usati come origine di associazione" in Panoramica delle origini di associazione.

Uso della sintassi XAML per gli attributi

<object ItemsSource="bindingDeclaration"/>

Valori XAML

bindingDeclaration Dichiarazione Binding . Per altre informazioni, vedere Estensione markup binding .

Informazioni proprietà di dipendenza

Campo Identificatore	ItemsSourceProperty
Proprietà dei metadati impostate su true	Nessuno