ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource Property

Définition

Obtient ou définit une collection utilisée pour générer le contenu du 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; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Valeur de propriété

Collection utilisée pour générer le contenu du ItemsControl.A collection that is used to generate the content of the ItemsControl. La valeur par défaut est null.The default is null.

Remarques

Modèle de contenu : Cette propriété peut être utilisée pour ajouter des éléments à ItemsControlun.Content Model: This property may be used to add items to an ItemsControl.

Un scénario courant consiste à utiliser un ItemsControl tel qu’un ListBox, ListViewun ou TreeView un pour afficher une collection de données, ou pour ItemsControl lier un à un objet de collection.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. Pour lier un ItemsControl à un objet de collection, utilisez ItemsSource la propriété.To bind an ItemsControl to a collection object, use the ItemsSource property. Notez que la ItemsSource propriété prend OneWay en charge la liaison par défaut.Note that the ItemsSource property supports OneWay binding by default.

Lorsque la ItemsSource propriété est définie, la Items collection est mise en lecture seule et à taille fixe.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

Lorsque ItemsSource est en cours d’utilisation, l’affectation null de la valeur à la propriété supprime la collection Itemset restaure l’utilisation de ItemCollection, qui sera vide.When ItemsSource is in use, setting the property to null removes the collection and restores usage to Items, which will be an empty ItemCollection. Lorsque ItemsSource n’est pas en cours d’utilisation, la valeur de nullcette propriété est, et null sa définition sur n’a aucun effet.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

Notes

Dans la plupart des cas, il n’est pas nécessaire d’implémenter vos propres collections.In most cases you do not need to implement your own collections. Au lieu de cela ObservableCollection<T> , envisagez d’utiliser ou d’autres collections existantes.Instead, consider using ObservableCollection<T> or other existing collections. Pour plus d’informations, consultez la section « objets de collection utilisés comme source de liaison » dans vue d’ensemble des sources de liaison.For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

Utilisation d'attributs XAMLXAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  

Valeurs XAMLXAML Values

bindingDeclarationbindingDeclaration
Binding Déclaration.A Binding declaration. Pour plus d’informations, consultez Binding Markup Extension .See Binding Markup Extension for more information.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field ItemsSourceProperty
Propriétés de métadonnées définies surtrueMetadata properties set to true Aucun.None

S’applique à