ItemsControl.ItemsSource Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

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é

IEnumerable

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

Attributs

BindableAttribute

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 à afficher une collection de données ou à lier un ItemsControl objet de collection. Pour lier un ItemsControl 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 effectuée en lecture seule et en taille fixe.

Quand ItemsSource elle est en cours d’utilisation, la définition de la propriété pour null supprimer la collection et restaure l’utilisation Itemssur , qui sera vide ItemCollection. Quand ItemsSource elle n’est pas utilisée, la valeur de cette propriété est null, et la définition de null celle-ci n’a aucun effet.

Notes

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

Utilisation d'attributs XAML

<object ItemsSource="bindingDeclaration"/>  

Valeurs XAML

bindingDeclaration
Déclaration Binding . Pour plus d’informations, consultez l’extension de balisage de liaison .

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

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