Condividi tramite


ItemsControl.ItemsSource Proprietà

Definizione

Ottiene o imposta una raccolta utilizzata 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à

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

Attributi

Commenti

Modello di contenuto: Questa proprietà può essere utilizzata per aggiungere elementi a un oggetto ItemsControl.

Uno scenario comune consiste nell'usare un ItemsControlListBoxoggetto, ad esempio , ListViewo TreeView per visualizzare una raccolta dati o per associare un ItemsControl oggetto a un insieme. 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 ItemsSource proprietà è impostata, la Items raccolta viene resa di sola lettura e dimensione fissa.

Quando ItemsSource è in uso, l'impostazione della proprietà su 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 impostandolo su null non ha alcun effetto.

Annotazioni

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" (Oggetti raccolta usati come origine di associazione) in Panoramica delle origini di binding.

Utilizzo degli attributi XAML

<object ItemsSource="bindingDeclaration"/>

Valori XAML

bindingDeclaration Dichiarazione Binding . Per altre informazioni, vedere Binding Markup Extension .See Binding Markup Extension for more information.

Informazioni sulle proprietà di dipendenza

Elemento Valore
Campo Identificatore ItemsSourceProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a