ItemsControl.ItemsSource Proprietà

Definizione

Ottiene o imposta una raccolta usata per generare il contenuto dell'oggetto ItemsControl.Gets or sets a collection used to generate the content of the 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.A collection that is used to generate the content of the ItemsControl. Il valore predefinito è null.The default is null.

Attributi

Commenti

Modello di contenuto: Questa proprietà può essere utilizzata per aggiungere elementi a un oggetto ItemsControl .Content Model: This property may be used to add items to an ItemsControl.

Uno scenario comune consiste nell'usare un ItemsControl ListBox oggetto, ad esempio, ListView o TreeView per visualizzare una raccolta di dati o per associare un ItemsControl oggetto a un oggetto raccolta.A common scenario is to use an ItemsControl such as a ListBox, ListView, or TreeView to display a data collection, or to bind an ItemsControl to a collection object. Per associare un ItemsControl oggetto a un oggetto Collection, utilizzare la ItemsSource Proprietà.To bind an ItemsControl to a collection object, use the ItemsSource property. Si noti che la ItemsSource proprietà supporta l' OneWay associazione per impostazione predefinita.Note that the ItemsSource property supports OneWay binding by default.

Quando la ItemsSource proprietà è impostata, la Items raccolta viene resa di sola lettura e a dimensione fissa.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

Quando ItemsSource è in uso, impostando la proprietà su viene null rimossa la raccolta e viene ripristinato l'utilizzo di Items , che sarà un oggetto vuoto ItemCollection .When ItemsSource is in use, setting the property to null removes the collection and restores usage to Items, which will be an empty ItemCollection. Quando ItemsSource non è in uso, il valore di questa proprietà è null e la relativa impostazione su non null ha alcun effetto.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

Nota

Nella maggior parte dei casi non è necessario implementare raccolte personalizzate.In most cases you do not need to implement your own collections. È invece consigliabile usare ObservableCollection<T> o altre raccolte esistenti.Instead, consider using ObservableCollection<T> or other existing collections. Per ulteriori informazioni, vedere "raccolta di oggetti utilizzati come origine del binding" in Cenni preliminari sulle origini di associazione.For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  

Valori XAMLXAML Values

bindingDeclarationbindingDeclaration
Una Binding dichiarazione.A Binding declaration. Per ulteriori informazioni, vedere Binding Markup Extension .See Binding Markup Extension for more information.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field ItemsSourceProperty
Proprietà dei metadati impostate su trueMetadata properties set to true NessunoNone

Si applica a