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 utilizzata per aggiungere elementi a un oggetto ItemsControl.

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

Quando la proprietà è impostata, l'insieme ItemsSource Items viene reso di sola lettura e di dimensioni fisse.

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

Nota

Nella maggior parte dei casi non è necessario implementare raccolte personalizzate. Prendere invece in considerazione l'uso ObservableCollection<T> di o altre raccolte esistenti. Per altre informazioni, vedere "Collection Objects Used as Binding Source" in Binding Sources Overview .For more information, see the Collection Objects Used as Binding Source" in Binding Sources Overview.

Uso della sintassi XAML per gli attributi

<object ItemsSource="bindingDeclaration"/>  

Valori XAML

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

Informazioni proprietà di dipendenza

Campo Identificatore	ItemsSourceProperty
Proprietà dei metadati impostate su true	Nessuno