ItemCollection Classe

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Contient la liste des éléments qui constituent le contenu de ItemsControl.

public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::ICollectionViewLiveShaping, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
public sealed class ItemCollection : System.Windows.Data.CollectionView, System.Collections.IList, System.ComponentModel.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties, System.Windows.IWeakEventListener

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
    inherit CollectionView
    interface ICollection
    interface IEnumerable
    interface IList
    interface ICollectionViewLiveShaping
    interface IEditableCollectionView
    interface IEditableCollectionViewAddNewItem
    interface IItemProperties
    interface IWeakEventListener

Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements ICollectionViewLiveShaping, IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener

Héritage

Object

DispatcherObject

CollectionView

ItemCollection

Attributs

LocalizabilityAttribute

Implémente

ICollection IEnumerable IList IEditableCollectionView IItemProperties IWeakEventListener IEditableCollectionViewAddNewItem ICollectionViewLiveShaping

Exemples

Si vous avez un ItemsControl, tel qu’un qui a du ListBox contenu, vous pouvez utiliser la Items propriété pour accéder à , ItemCollectionqui est une vue. Étant donné qu’il s’agit d’une vue, vous pouvez ensuite utiliser les fonctionnalités liées à l’affichage, telles que le tri, le filtrage et le regroupement. Notez que lorsque ItemsSource est défini, les opérations d’affichage délèguent à la vue sur la collection ItemsSource. Par conséquent, ItemCollection prend en charge le tri, le filtrage et le regroupement uniquement si la vue déléguée les a pris en charge.

L’exemple suivant montre comment trier le contenu d’un ListBox nommé myListBox. Dans cet exemple, Content est le nom de la propriété à trier.

myListBox.Items.SortDescriptions.Add(
    new SortDescription("Content", ListSortDirection.Descending));

myListBox.Items.SortDescriptions.Add(New SortDescription("Content", ListSortDirection.Descending))

Dans ce cas, la vue peut ou non être la vue par défaut, selon la façon dont les données sont configurées sur votre ItemsControl. Par exemple, lorsque la ItemsSource propriété est liée à un CollectionViewSource, la vue que vous obtenez à l’aide de la Items propriété n’est pas l’affichage par défaut.

Si votre ItemsControl est lié (vous utilisez la ItemsSource propriété ), vous pouvez effectuer les opérations suivantes pour obtenir l’affichage par défaut :

CollectionView myView;

Private myView As CollectionView

myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);

myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)

Vous pouvez également spécifier des critères de filtrage, de tri et de regroupement en XAML à l’aide CollectionViewSourcede .

Remarques

ItemCollection gère une collection d’éléments tels que des chaînes, des objets, des nœuds XML, des éléments et d’autres collections. Un ItemsControl utilise les données du ItemCollection pour générer son contenu. Si vous souhaitez agréger plusieurs collections, affectez un CompositeCollection à la ItemsSource propriété de votre ItemsControl.

Utilisez la Items propriété ou la ItemsSource propriété pour spécifier la collection qui doit être utilisée pour générer le contenu de votre ItemsControl. Lorsque la ItemsSource propriété est définie, la Items collection est en lecture seule et de taille fixe. Cela signifie que si vous utilisez la ItemsSource propriété , vous ne pouvez pas ajouter, supprimer ou modifier directement des éléments dans le ItemCollection .

ItemCollection est un CollectionView et fournit par conséquent des fonctionnalités d’affichage de regroupement, telles que le tri, le regroupement et le filtrage. Pour plus d'informations, consultez SortDescriptions, Filter et GroupDescriptions.

Pour plus d’informations sur les vues de collection, consultez Vue d’ensemble de la liaison de données.

Propriétés

AllowsCrossThreadChanges	Obtient une valeur indiquant si un autre thread que celui qui a créé la CollectionView peut modifier la SourceCollection. (Hérité de CollectionView)
CanChangeLiveFiltering	Obtient une valeur qui indique si la vue de collection prend en charge l’activation ou la désactivation du filtrage des données en temps réel.
CanChangeLiveGrouping	Obtient une valeur qui indique si cette vue de collection prend en charge l'activation et la désactivation du groupage des données en temps réel.
CanChangeLiveSorting	Obtient une valeur qui indique si cette vue de collection prend en charge l'activation et la désactivation du tri des données en temps réel.
CanFilter	Obtient une valeur qui indique si la vue de collection prend en charge le filtrage.
CanGroup	Obtient une valeur qui indique si cette collection prend en charge le regroupement.
CanSort	Obtient une valeur qui indique si cette vue de collection prend en charge le tri.
Comparer	Retourne un objet que vous pouvez utiliser pour effectuer des comparaisons entre éléments de la vue. (Hérité de CollectionView)
Count	Obtient le nombre d'enregistrements dans la collection.
Culture	Obtient ou définit les informations de culture à utiliser pendant le tri. (Hérité de CollectionView)
CurrentItem	Obtient l'élément actif de la vue.
CurrentPosition	Obtient la position ordinale de l'élément actuel dans la vue.
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
Filter	Obtient ou définit un rappel utilisé pour déterminer si un élément peut être inclus dans la vue.
GroupDescriptions	Obtient une collection d'objets GroupDescription qui définit comment regrouper les éléments.
Groups	Obtient les groupes de niveau supérieur qui sont construits d'après les GroupDescriptions.
IsCurrentAfterLast	Obtient une valeur qui indique si l'élément actuel de la vue est au-delà de la fin de la collection.
IsCurrentBeforeFirst	Obtient une valeur qui indique si l'élément actuel de la vue est au delà du début de la collection.
IsCurrentInSync	Obtient une valeur qui indique si CurrentItem est à la CurrentPosition. (Hérité de CollectionView)
IsDynamic	Obtient une valeur qui indique si la collection sous-jacente fournit des notifications de modification. (Hérité de CollectionView)
IsEmpty	Obtient une valeur qui indique si la vue (filtrée) résultante est vide.
IsInUse	Obtient une valeur indiquant si un objet s'abonne aux événements de cette CollectionView. (Hérité de CollectionView)
IsLiveFiltering	Obtient ou définit une valeur qui indique si le filtrage des données en temps réel est activé.
IsLiveGrouping	Obtient ou définit une valeur qui indique si le groupage des données en temps réel est activé.
IsLiveSorting	Obtient ou définit une valeur qui indique si le tri en temps réel est activé.
IsRefreshDeferred	Obtient une valeur qui indique s'il y a un DeferRefresh() en cours d'utilisation. (Hérité de CollectionView)
Item[Int32]	Obtient ou définit l'élément à l'index de base zéro donné.
LiveFilteringProperties	Obtient une collection de chaînes qui spécifient les propriétés qui participent au filtrage des données en temps réel.
LiveGroupingProperties	Obtient une collection de chaînes qui spécifient les propriétés qui participent au groupage des données en temps réel.
LiveSortingProperties	Obtient une collection de chaînes qui spécifient les propriétés qui participent au tri des données en temps réel.
NeedsRefresh	Obtient une valeur qui indique si la collection doit être actualisée.
SortDescriptions	Obtient une collection d’objets SortDescription qui décrivent le mode de tri des éléments de la collection dans la vue.
SourceCollection	Obtient la collection non triée et non filtrée qui sert de base à cette vue de collection.
UpdatedOutsideDispatcher	Obtient une valeur qui indique s’il a été nécessaire de mettre à jour le journal des modifications, car une CollectionChanged notification a été reçue sur un autre thread sans entrer au préalable le répartiteur de threads d’interface utilisateur. (Hérité de CollectionView)

Méthodes

Add(Object)	Ajoute un élément à ItemCollection.
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
Clear()	Supprime la collection et diffuse les références à tous les éléments actuellement dans la collection.
ClearChangeLog()	Obsolète. Efface toutes modifications en attente du journal des modifications. (Hérité de CollectionView)
ClearPendingChanges()	Efface les modifications non traitées relatives à la collection. (Hérité de CollectionView)
Contains(Object)	Retourne une valeur qui indique si l'élément spécifié est dans cette vue.
CopyTo(Array, Int32)	Copie les éléments de la collection dans un tableau, en commençant au niveau d’un index de tableau particulier.
DeferRefresh()	Entre dans un cycle différé que vous pouvez utiliser pour fusionner des modifications de la vue et retarder l’actualisation automatique.
DetachFromSourceCollection()	Supprime la référence à la collection sous-jacente de la CollectionView. (Hérité de CollectionView)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un objet que vous pouvez utiliser pour énumérer les éléments de la vue. (Hérité de CollectionView)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetItemAt(Int32)	Retourne l'élément à l'index de base zéro spécifié dans la vue.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(Object)	Retourne l'index dans cette collection où est localisé l'élément spécifié.
Insert(Int32, Object)	Insère un élément dans la collection à l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MoveCurrentTo(Object)	Définit l'élément spécifié dans la collection comme CurrentItem.
MoveCurrentToFirst()	Définit le premier élément de la vue comme le CurrentItem.
MoveCurrentToLast()	Définit le dernier élément de la vue comme le CurrentItem.
MoveCurrentToNext()	Définit l'élément qui suit le CurrentItem dans la vue comme le CurrentItem.
MoveCurrentToPosition(Int32)	Définit l'élément situé à l'index spécifié comme devant être le CurrentItem de la vue.
MoveCurrentToPrevious()	Définit l'élément qui vient avant l'CurrentItem dans la vue en tant qu'CurrentItem.
OKToChangeCurrent()	Retourne une valeur qui indique si la vue peut changer d'élément CurrentItem. (Hérité de CollectionView)
OnAllowsCrossThreadChangesChanged()	Se produit quand la propriété AllowsCrossThreadChanges change. (Hérité de CollectionView)
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Obsolète. Appelée par la classe de base pour notifier la classe dérivée qu'un événement CollectionChanged a été publié à la file d'attente de messages. (Hérité de CollectionView)
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Déclenche l’événement CollectionChanged. (Hérité de CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	Déclenche l’événement CollectionChanged. (Hérité de CollectionView)
OnCurrentChanged()	Déclenche l’événement CurrentChanged. (Hérité de CollectionView)
OnCurrentChanging()	Déclenche un événement CurrentChanging qui ne peut pas être annulé. (Hérité de CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)	Déclenche l'événement CurrentChanging à l'aide des arguments spécifiés. (Hérité de CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)	Déclenche l'événement PropertyChanged à l'aide des arguments spécifiés. (Hérité de CollectionView)
PassesFilter(Object)	Retourne une valeur qui indique si l'élément spécifié appartient à cette vue.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	En cas de substitution dans une classe dérivée, traite une seule modification sur le thread d’interface utilisateur. (Hérité de CollectionView)
ProcessPendingChanges()	Garantit que toutes les modifications en attente applicables à la collection ont été validées. (Hérité de CollectionView)
Refresh()	Recrée la vue. (Hérité de CollectionView)
RefreshOrDefer()	Actualise la vue ou spécifie que la vue doit être actualisée lorsque le cycle différé se termine. (Hérité de CollectionView)
RefreshOverride()	Recrée la vue. (Hérité de CollectionView)
Remove(Object)	Supprime de la collection ou de la vue la référence à l'élément spécifiée.
RemoveAt(Int32)	Supprime l'élément à l'index spécifié dans la collection ou dans la vue.
SetCurrent(Object, Int32)	Définit l'élément et l'index spécifiés comme valeurs des propriétés CurrentItem et CurrentPosition. (Hérité de CollectionView)
SetCurrent(Object, Int32, Int32)	Définit l'élément et l'index spécifiés comme valeurs des propriétés CurrentItem et CurrentPosition. Cette méthode peut être appelée à partir d'un constructeur d'une classe dérivée. (Hérité de CollectionView)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Événements

CollectionChanged	Se produit lorsque la vue a changé. (Hérité de CollectionView)
CurrentChanged	Se produit après la modification de CurrentItem. (Hérité de CollectionView)
CurrentChanging	Se produit lorsque CurrentItem est en cours de modification. (Hérité de CollectionView)
PropertyChanged	Se produit lorsqu'une valeur de propriété a été modifiée. (Hérité de CollectionView)

Implémentations d’interfaces explicites

ICollection.IsSynchronized	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.
ICollection.SyncRoot	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.
IEditableCollectionView.AddNew()	Ajoute un nouvel élément à la collection.
IEditableCollectionView.CanAddNew	Obtient une valeur qui indique si un nouvel élément peut être ajouté à la collection.
IEditableCollectionView.CanCancelEdit	Obtient une valeur qui indique si la vue de collection peut ignorer les modifications en attente et restaurer les valeurs d'origine d'un objet modifié.
IEditableCollectionView.CancelEdit()	Met fin à la transaction de modification et, si possible, restaure la valeur d’origine de l’élément.
IEditableCollectionView.CancelNew()	Met fin à la transaction d'ajout et ignore le nouvel élément en attente.
IEditableCollectionView.CanRemove	Obtient une valeur qui indique si un élément peut être supprimé de la collection.
IEditableCollectionView.CommitEdit()	Met fin à la transaction de modification et enregistre les modifications en attente.
IEditableCollectionView.CommitNew()	Met fin à la transaction d'ajout et enregistre le nouvel élément en attente.
IEditableCollectionView.CurrentAddItem	Obtient l'élément ajouté pendant la transaction d'ajout en cours.
IEditableCollectionView.CurrentEditItem	Obtient l'élément de la collection qui est modifié.
IEditableCollectionView.EditItem(Object)	Commence une transaction de modification de l’élément spécifié.
IEditableCollectionView.IsAddingNew	Obtient une valeur qui indique si une transaction d'ajout est en cours.
IEditableCollectionView.IsEditingItem	Obtient une valeur qui indique si une transaction de modification est en cours.
IEditableCollectionView.NewItemPlaceholderPosition	Obtient ou définit la position du nouvel espace réservé d’élément dans la vue de collection.
IEditableCollectionView.Remove(Object)	Supprime l’élément spécifié de la collection.
IEditableCollectionView.RemoveAt(Int32)	Supprime de la collection l'élément situé à la position spécifiée.
IEditableCollectionViewAddNewItem.AddNewItem(Object)	Ajoute l’objet spécifié à la collection.
IEditableCollectionViewAddNewItem.CanAddNewItem	Obtient une valeur qui indique si un objet spécifié peut être ajouté à la collection.
IEnumerable.GetEnumerator()	Retourne un objet IEnumerator que vous pouvez utiliser pour énumérer les éléments de la vue. (Hérité de CollectionView)
IItemProperties.ItemProperties	Obtient une collection qui contient des informations à propos des propriétés disponibles sur les éléments dans une collection.
IList.IsFixedSize	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.
IList.IsReadOnly	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.
INotifyCollectionChanged.CollectionChanged	Se produit lorsque la vue a changé. (Hérité de CollectionView)
INotifyPropertyChanged.PropertyChanged	Se produit en cas de modification d'une valeur de propriété. (Hérité de CollectionView)
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)	Reçoit des événements du gestionnaire d'événements centralisé.

Méthodes d’extension

Voir aussi

• ItemsControl