ItemsControl.ItemsSource Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |