ItemsControl.ItemsSource Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 |