ListCollectionView Classe

Définition

Représente l’affichage des collections qui implémentent IList.Represents the collection view for collections that implement IList.

public ref class ListCollectionView : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::ICollectionViewLiveShaping, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties
public ref class ListCollectionView : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::IEditableCollectionView, System::ComponentModel::IItemProperties
public ref class ListCollectionView : System::Windows::Data::CollectionView, System::Collections::IComparer, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties
public class ListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties
public class ListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.IEditableCollectionView, System.ComponentModel.IItemProperties
public class ListCollectionView : System.Windows.Data.CollectionView, System.Collections.IComparer, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties
type ListCollectionView = class
    inherit CollectionView
    interface IComparer
    interface ICollectionViewLiveShaping
    interface IEditableCollectionView
    interface IEditableCollectionViewAddNewItem
    interface IItemProperties
type ListCollectionView = class
    inherit CollectionView
    interface IComparer
    interface IEditableCollectionView
    interface IItemProperties
type ListCollectionView = class
    inherit CollectionView
    interface IComparer
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface IItemProperties
type ListCollectionView = class
    inherit CollectionView
    interface IComparer
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface ICollectionViewLiveShaping
    interface IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements ICollectionViewLiveShaping, IComparer, IEditableCollectionViewAddNewItem, IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements IComparer, IEditableCollectionView, IItemProperties
Public Class ListCollectionView
Inherits CollectionView
Implements IComparer, IEditableCollectionViewAddNewItem, IItemProperties
Héritage
Implémente

Remarques

Lorsque vous établissez une liaison à une collecte de données, vous pouvez trier, filtrer ou regrouper les données.When you bind to a data collection, you may want to sort, filter, or group the data. Pour ce faire, vous utilisez des vues de collection.To do that, you use collection views. Vous pouvez considérer un CollectionView comme la couche au-dessus de la collection de sources de liaison qui vous permet de parcourir et d’afficher la collection source en fonction des requêtes de tri, de filtrage et de groupe, sans avoir à manipuler la collection source sous-jacente elle-même.You can think of a CollectionView as the layer on top of the binding source collection that allows you to navigate and display the source collection based on sort, filter, and group queries, all without having to manipulate the underlying source collection itself. Si la collection source implémente l’interface INotifyCollectionChanged, les modifications déclenchées par l’événement CollectionChanged sont propagées aux vues.If the source collection implements the INotifyCollectionChanged interface, the changes raised by the CollectionChanged event are propagated to the views.

Toutes les collections ont un CollectionViewpar défaut.All collections have a default CollectionView. Pour toutes les collections qui implémentent IList, l’objet ListCollectionView est l’objet de vue par défaut.For all collections implementing IList, the ListCollectionView object is the default view object. La BindingListCollectionView est la classe d’affichage de collection utilisée pour les collections qui implémentent IBindingList.The BindingListCollectionView is the collection view class used for collections that implement IBindingList. Pour obtenir la vue par défaut, utilisez la méthode GetDefaultView.To get the default view, you use the GetDefaultView method. Pour obtenir un exemple, consultez Comment : obtenir la vue par défaut d’une collection de données.For an example, see How to: Get the Default View of a Data Collection.

Pour plus d’informations sur les vues de collection, consultez vue d’ensemblede la liaison de données.For more information about collection views, see Data Binding Overview.

Constructeurs

ListCollectionView(IList)

Initialise une nouvelle instance de la classe ListCollectionView, à l'aide d'une collection fournie qui implémente IList.Initializes a new instance of the ListCollectionView class, using a supplied collection that implements IList.

Propriétés

ActiveComparer

Obtient ou définit le comparateur actuellement actif qui est utilisé pour le tri.Gets or sets the current active comparer that is used in sorting.

ActiveFilter

Obtient ou définit le rappel Filter actif actuel.Gets or sets the current active Filter callback.

AllowsCrossThreadChanges

Obtient une valeur indiquant si un autre thread que celui qui a créé la CollectionView peut modifier la SourceCollection.Gets a value that indicates whether a thread other than the one that created the CollectionView can change the SourceCollection.

(Hérité de CollectionView)
CanAddNew

Obtient une valeur qui indique si un nouvel élément peut être ajouté à la collection.Gets a value that indicates whether a new item can be added to the collection.

CanAddNewItem

Obtient une valeur qui indique si un objet spécifié peut être ajouté à la collection.Gets a value that indicates whether a specified object can be added to the collection.

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é.Gets a value that indicates whether the collection view can discard pending changes and restore the original values of an edited object.

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.Gets a value that indicates whether the collection view supports turning filtering data in real time on or off.

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.Gets a value that indicates whether the collection view supports turning grouping data in real time on or off.

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.Gets a value that indicates whether the collection view supports turning sorting data in real time on or off.

CanFilter

Obtient une valeur qui indique si la vue prend en charge le filtrage basé sur le rappel.Gets a value that indicates whether the view supports callback-based filtering.

CanGroup

Obtient une valeur qui indique si la vue de collection prend en charge le regroupement.Gets a value that indicates whether the collection view supports grouping.

CanRemove

Obtient une valeur qui indique si un élément peut être supprimé de la collection.Gets a value that indicates whether an item can be removed from the collection.

CanSort

Obtient une valeur qui indique si la vue de collection prend en charge le tri.Gets a value that indicates whether the collection view supports sorting.

Comparer

Retourne un objet que vous pouvez utiliser pour effectuer des comparaisons entre éléments de la vue.Returns an object that you can use to compare items in the view.

(Hérité de CollectionView)
Count

Obtient le nombre estimé d'enregistrements.Gets the estimated number of records.

Culture

Obtient ou définit les informations de culture à utiliser pendant le tri.Gets or sets the culture information to use during sorting.

(Hérité de CollectionView)
CurrentAddItem

Obtient l'élément ajouté pendant la transaction d'ajout en cours.Gets the item that is being added during the current add transaction.

CurrentEditItem

Obtient l'élément de la collection qui est modifié.Gets the item in the collection that is being edited.

CurrentItem

Obtient l'élément actif de la vue.Gets the current item in the view.

(Hérité de CollectionView)
CurrentPosition

Obtient la position ordinale de CurrentItem dans la vue (éventuellement triée et filtrée).Gets the ordinal position of the CurrentItem within the (optionally sorted and filtered) view.

(Hérité de CollectionView)
CustomSort

Obtient ou définit un objet personnalisé qui implémente IComparer pour trier les éléments dans la vue.Gets or sets a custom object that implements IComparer to sort items in the view.

Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Hérité de DispatcherObject)
Filter

Obtient ou définit une méthode utilisée pour déterminer si un élément peut être inclus dans la vue.Gets or sets a method that is used to determine whether an item is suitable for inclusion in the view.

GroupBySelector

Obtient ou définit un délégué pour sélectionner GroupDescription comme une fonction du groupe parent et son niveau.Gets or sets a delegate to select the GroupDescription as a function of the parent group and its level.

GroupDescriptions

Obtient une collection d'objets GroupDescription qui décrivent comment les éléments de la collection sont regroupés dans la vue.Gets a collection of GroupDescription objects that describe how the items in the collection are grouped in the view.

Groups

Obtient les groupes de niveau supérieur.Gets the top-level groups.

InternalCount

Obtient le nombre d'enregistrements dans InternalList.Gets the number of records in the InternalList.

InternalList

Obtient la liste filtrée et triée des éléments.Gets the filtered and sorted list of items.

IsAddingNew

Obtient une valeur qui indique si une transaction d'ajout est en cours.Gets a value that indicates whether an add transaction is in progress.

IsCurrentAfterLast

Obtient une valeur qui indique si le CurrentItem de la vue est au-delà de la fin de la collection.Gets a value that indicates whether the CurrentItem of the view is beyond the end of the collection.

(Hérité de CollectionView)
IsCurrentBeforeFirst

Obtient une valeur qui indique si le CurrentItem de la vue est avant le début de la collection.Gets a value that indicates whether the CurrentItem of the view is before the beginning of the collection.

(Hérité de CollectionView)
IsCurrentInSync

Obtient une valeur qui indique si CurrentItem est à la CurrentPosition.Gets a value that indicates whether the CurrentItem is at the CurrentPosition.

(Hérité de CollectionView)
IsDataInGroupOrder

Obtient ou définit une valeur qui indique si la liste d'éléments (après avoir appliqué le tri et les filtres, le cas échéant) est déjà dans le bon ordre pour procéder au regroupement.Gets or sets a value that indicates whether the list of items (after applying the sort and filters, if any) is already in the correct order for grouping.

IsDynamic

Obtient une valeur qui indique si la collection sous-jacente fournit des notifications de modification.Gets a value that indicates whether the underlying collection provides change notifications.

(Hérité de CollectionView)
IsEditingItem

Obtient une valeur qui indique si une transaction de modification est en cours.Gets a value that indicates whether an edit transaction is in progress.

IsEmpty

Retourne une valeur qui indique si la vue (filtrée) résultante est vide.Returns a value that indicates whether the resulting (filtered) view is empty.

IsGrouping

Obtient une valeur qui indique s'il y a des groupes dans la vue.Gets a value that indicates whether there are groups in the view.

IsInUse

Obtient une valeur indiquant si un objet s'abonne aux événements de cette CollectionView.Gets a value that indicates whether any object is subscribing to the events of this 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é.Gets or sets a value that indicates whether filtering data in real time is enabled.

IsLiveGrouping

Obtient ou définit une valeur qui indique si le groupage des données en temps réel est activé.Gets or sets a value that indicates whether grouping data in real time is enabled.

IsLiveSorting

Obtient ou définit une valeur qui indique si le tri en temps réel est activé.Gets or sets a value that indicates whether sorting in real time is enabled.

IsRefreshDeferred

Obtient une valeur qui indique s'il y a un DeferRefresh() en cours d'utilisation.Gets a value that indicates whether there is an outstanding DeferRefresh() in use.

(Hérité de CollectionView)
ItemProperties

Obtient une collection d'objets qui décrit les propriétés des éléments dans la collection.Gets a collection of objects that describes the properties of the items in the collection.

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.Gets a collection of strings that specify the properties that participate in filtering data in real time.

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.Gets a collection of strings that specify the properties that participate in grouping data in real time.

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.Gets a collection of strings that specify the properties that participate in sorting data in real time.

NeedsRefresh

Obtient une valeur qui indique si la vue doit être actualisée.Gets a value that indicates whether the view needs to be refreshed.

(Hérité de CollectionView)
NewItemPlaceholderPosition

Obtient ou définit la position du nouvel espace réservé d'élément dans ListCollectionView.Gets or sets the position of the new item placeholder in the ListCollectionView.

SortDescriptions

Obtient une collection d’objets SortDescription qui décrit comment les éléments de la collection sont triés dans la vue.Gets a collection of SortDescription objects that describes how the items in the collection are sorted in the view.

SourceCollection

Retourne la collection non filtrée sous-jacente.Returns the underlying unfiltered collection.

(Hérité de CollectionView)
UpdatedOutsideDispatcher

Obtient une valeur qui indique s'il a été nécessaire de mettre à jour le journal des modifications parce qu'une notification CollectionChanged a été reçue sur un thread différent sans entrer d'abord dans le distributeur de thread interface utilisateur (UI)user interface (UI).Gets a value that indicates whether it has been necessary to update the change log because a CollectionChanged notification has been received on a different thread without first entering the interface utilisateur (UI)user interface (UI) thread dispatcher.

(Hérité de CollectionView)
UsesLocalArray

Obtient une valeur qui indique si une copie privée des données est nécessaire pour le tri et le filtrage.Gets a value that indicates whether a private copy of the data is needed for sorting and filtering.

Méthodes

AddNew()

Commence une transaction d'ajout et retourne le nouvel élément en attente.Starts an add transaction and returns the pending new item.

AddNewItem(Object)

Ajoute l'objet spécifié à la collection.Adds the specified object to the collection.

CancelEdit()

Met fin à la transaction de modification et, si possible, restaure la valeur d'origine de l'élément.Ends the edit transaction, and if possible, restores the original value to the item.

CancelNew()

Met fin à la transaction d'ajout et ignore le nouvel élément en attente.Ends the add transaction and discards the pending new item.

CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)
ClearChangeLog()

Efface toutes modifications en attente du journal des modifications.Clears any pending changes from the change log.

(Hérité de CollectionView)
ClearPendingChanges()

Efface les modifications non traitées relatives à la collection.Clears unprocessed changed to the collection.

(Hérité de CollectionView)
CommitEdit()

Met fin à la transaction de modification et enregistre les modifications en attente.Ends the edit transaction and saves the pending changes.

CommitNew()

Met fin à la transaction d'ajout et enregistre le nouvel élément en attente.Ends the add transaction and saves the pending new item.

Compare(Object, Object)

Compare deux objets et retourne une valeur qui indique si l'un d'entre eux est inférieur, égal ou supérieur à l'autre.Compares two objects and returns a value that indicates whether one is less than, equal to, or greater than the other.

Contains(Object)

Retourne une valeur qui indique si un élément donné appartient à la vue de collection.Returns a value that indicates whether a given item belongs to the collection view.

DeferRefresh()

Entre dans un cycle différé que vous pouvez utiliser pour fusionner des modifications de la vue et retarder l'actualisation automatique.Enters a defer cycle that you can use to merge changes to the view and delay automatic refresh.

(Hérité de CollectionView)
DetachFromSourceCollection()

Supprime la référence à la collection sous-jacente de la CollectionView.Removes the reference to the underlying collection from the CollectionView.

(Hérité de CollectionView)
EditItem(Object)

Commence une transaction de modification de l’élément spécifié.Begins an edit transaction of the specified item.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un objet que vous pouvez utiliser pour énumérer les éléments de la vue.Returns an object that you can use to enumerate the items in the view.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetItemAt(Int32)

Extrait l'élément à la position spécifiée dans la vue.Retrieves the item at the specified position in the view.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IndexOf(Object)

Retourne l'index où l'élément de données spécifié appartient à la collection, ou -1 si l'index de cet élément est inconnu.Returns the index where the given data item belongs in the collection, or -1 if the index of that item is unknown.

InternalContains(Object)

Retourne une valeur qui indique si InternalList contient l'élément.Return a value that indicates whether the InternalList contains the item.

InternalGetEnumerator()

Retourne un énumérateur pour InternalList.Returns an enumerator for the InternalList.

InternalIndexOf(Object)

Retourne l'index de l'élément spécifié dans InternalList.Returns the index of the specified item in the InternalList.

InternalItemAt(Int32)

Retourne l'élément à l'index donné dans InternalList.Returns the item at the given index in the InternalList.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MoveCurrentTo(Object)

Définit l'élément spécifié comme devant être le CurrentItem de la vue.Sets the specified item to be the CurrentItem in the view.

(Hérité de CollectionView)
MoveCurrentToFirst()

Définit le premier élément de la vue comme CurrentItem.Sets the first item in the view as the CurrentItem.

(Hérité de CollectionView)
MoveCurrentToLast()

Définit le dernier élément de la vue comme CurrentItem.Sets the last item in the view as the CurrentItem.

(Hérité de CollectionView)
MoveCurrentToNext()

Définit l'élément après CurrentItem dans la vue comme CurrentItem.Sets the item after the CurrentItem in the view as the CurrentItem.

(Hérité de CollectionView)
MoveCurrentToPosition(Int32)

Définit l'élément situé à l'index spécifié comme devant être le CurrentItem de la vue.Sets the item at the specified index to be the CurrentItem in the view.

MoveCurrentToPrevious()

Définit l'élément avant CurrentItem dans la vue comme CurrentItem.Sets the item before the CurrentItem in the view as the CurrentItem.

(Hérité de CollectionView)
OKToChangeCurrent()

Retourne une valeur qui indique si la vue peut changer d'élément CurrentItem.Returns a value that indicates whether the view can change which item is the CurrentItem.

(Hérité de CollectionView)
OnAllowsCrossThreadChangesChanged()

Se produit quand la propriété AllowsCrossThreadChanges change.Occurs when the AllowsCrossThreadChanges property changes.

OnBeginChangeLogging(NotifyCollectionChangedEventArgs)

Appelée par la classe de base pour notifier la classe dérivée qu'un événement CollectionChanged a été publié dans la file d'attente de messages.Called by the base class to notify the derived class that a CollectionChanged event has been posted to the message queue.

OnCollectionChanged(NotifyCollectionChangedEventArgs)

Déclenche l'événement CollectionChanged.Raises the CollectionChanged event.

(Hérité de CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)

Déclenche l'événement CollectionChanged.Raises the CollectionChanged event.

(Hérité de CollectionView)
OnCurrentChanged()

Déclenche l'événement CurrentChanged.Raises the CurrentChanged event.

(Hérité de CollectionView)
OnCurrentChanging()

Déclenche un événement CurrentChanging qui ne peut pas être annulé.Raises a CurrentChanging event that is not cancelable.

(Hérité de CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)

Déclenche l'événement CurrentChanging à l'aide des arguments spécifiés.Raises the CurrentChanging event with the specified arguments.

(Hérité de CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)

Déclenche l'événement PropertyChanged à l'aide des arguments spécifiés.Raises the PropertyChanged event using the specified arguments.

(Hérité de CollectionView)
PassesFilter(Object)

Retourne une valeur qui indique si l'élément de la collection sous-jacente spécifié appartient à la vue.Returns a value that indicates whether the specified item in the underlying collection belongs to the view.

ProcessCollectionChanged(NotifyCollectionChangedEventArgs)

Gère des événements CollectionChanged.Handles CollectionChanged events.

ProcessPendingChanges()

Garantit que toutes les modifications en attente applicables à la collection ont été validées.Ensures that all pending changes to the collection have been committed.

(Hérité de CollectionView)
Refresh()

Recrée la vue.Re-creates the view.

(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.Refreshes the view or specifies that the view needs to be refreshed when the defer cycle completes.

(Hérité de CollectionView)
RefreshOverride()

Recrée la vue.Recreates the view.

Remove(Object)

Supprime l’élément spécifié de la collection.Removes the specified item from the collection.

RemoveAt(Int32)

Supprime de la collection l’élément situé à la position spécifiée.Removes the item at the specified position from the collection.

SetCurrent(Object, Int32)

Définit l'élément et l'index spécifiés comme valeurs des propriétés CurrentItem et CurrentPosition.Sets the specified item and index as the values of the CurrentItem and CurrentPosition properties.

(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.Sets the specified item and index as the values of the CurrentItem and CurrentPosition properties. Cette méthode peut être appelée à partir d'un constructeur d'une classe dérivée.This method can be called from a constructor of a derived class.

(Hérité de CollectionView)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)

Événements

CollectionChanged

Se produit lorsque la vue a changé.Occurs when the view has changed.

(Hérité de CollectionView)
CurrentChanged

Se produit après la modification de CurrentItem.Occurs after the CurrentItem has changed.

(Hérité de CollectionView)
CurrentChanging

Se produit lorsque CurrentItem est en cours de modification.Occurs when the CurrentItem is changing.

(Hérité de CollectionView)
PropertyChanged

Se produit lorsqu'une valeur de propriété a été modifiée.Occurs when a property value has changed.

(Hérité de CollectionView)

Implémentations d’interfaces explicites

IComparer.Compare(Object, Object)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) et n’est pas destiné à être directement utilisé à partir de votre code.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

IEnumerable.GetEnumerator()

Retourne un objet IEnumerator que vous pouvez utiliser pour énumérer les éléments de la vue.Returns an IEnumerator object that you can use to enumerate the items in the view.

(Hérité de CollectionView)
INotifyCollectionChanged.CollectionChanged

Se produit lorsque la vue a changé.Occurs when the view has changed.

(Hérité de CollectionView)
INotifyPropertyChanged.PropertyChanged

Se produit lorsqu'une valeur de propriété change.Occurs when a property value changes.

(Hérité de CollectionView)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à