ItemsControl.ItemsSource Propriété

Définition

Obtient ou définit une collection utilisée pour générer le contenu de 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

Valeur de propriété

Collection qui est utilisée pour générer le contenu de ItemsControl. La valeur par défaut est null.

Attributs

Remarques

Modèle de contenu : Cette propriété peut être utilisée pour ajouter des éléments à un ItemsControl.

Un scénario courant consiste à utiliser un ItemsControl tel qu’un ListBox, ListViewou TreeView pour afficher une collection de données, ou à lier un ItemsControl à un objet de collection. Pour lier un ItemsControl objet à un objet de collection, utilisez la ItemsSource propriété . Notez que la propriété prend en charge OneWay la ItemsSource liaison par défaut.

Lorsque la ItemsSource propriété est définie, la Items collection est en lecture seule et de taille fixe.

Quand ItemsSource est en cours d’utilisation, la définition de la propriété sur null supprime la collection et restaure l’utilisation sur Items, qui sera un vide ItemCollection. Lorsque ItemsSource n’est pas utilisé, la valeur de cette propriété est null, et sa définition sur null n’a aucun effet.

Notes

Dans la plupart des cas, vous n’avez pas besoin d’implémenter vos propres collections. Au lieu de cela, envisagez d’utiliser ObservableCollection<T> ou d’autres collections existantes. Pour plus d’informations, consultez « Objets de collection utilisés comme source de liaison » dans Vue d’ensemble des sources de liaison.

Utilisation d'attributs XAML

<object ItemsSource="bindingDeclaration"/>

Valeurs XAML

bindingDeclaration Une Binding déclaration. Pour plus d’informations, consultez Extension de balisage de liaison .

Informations sur les propriétés de dépendance

Champ Identificateur ItemsSourceProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à