Partager via


ItemCollection Classe

Définition

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::IEditableCollectionView, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
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.IEditableCollectionView, 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.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 IList
    interface ICollection
    interface IEnumerable
    interface IEditableCollectionView
    interface IItemProperties
    interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
    inherit CollectionView
    interface IList
    interface ICollection
    interface IEnumerable
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface IItemProperties
    interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
    inherit CollectionView
    interface IList
    interface ICollection
    interface IEnumerable
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface ICollectionViewLiveShaping
    interface IItemProperties
    interface 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 IEditableCollectionView, IItemProperties, IList, IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements ICollectionViewLiveShaping, IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener
Héritage
Attributs
Implémente

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

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi