Accueil Library Formation Code Téléchargements Support Evénements Communautés Forums
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

CollectionView, classe

.NET Framework 4.5

Représente une vue pour regrouper, trier, filtrer, et naviguer dans une collection de données.

Espace de noms :  System.Windows.Data
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
C#
C++
F#
VB
Copier 
public class CollectionView : DispatcherObject, 
	ICollectionView, IEnumerable, INotifyCollectionChanged, INotifyPropertyChanged
XAML
Copier 
Consultez la section Notes.

Le type CollectionView expose les membres suivants.

  NomDescription
Méthode publiqueCollectionViewInitialise une nouvelle instance de la classe CollectionView qui représente une vue de la collection spécifiée.
Début
  NomDescription
Propriété protégéeAllowsCrossThreadChangesObtient une valeur qui indique si un thread autre que celui qui l'a créé CollectionView peut modifier SourceCollection.
Propriété publiqueCanFilterObtient une valeur qui indique si la vue prend en charge le filtrage.
Propriété publiqueCanGroupObtient une valeur qui indique si la vue prend en charge le regroupement.
Propriété publiqueCanSortObtient une valeur qui indique si la vue prend en charge le tri.
Propriété publiqueComparerRetourne un objet que vous pouvez utiliser pour effectuer des comparaisons entre éléments de la vue.
Propriété publiqueCountObtient le nombre d'enregistrements dans la vue.
Propriété publiqueCultureObtient ou définit les informations de culture à utiliser pendant le tri.
Propriété publiqueCurrentItemObtient l'élément actuel de la vue.
Propriété publiqueCurrentPositionObtient la position ordinale de CurrentItem dans la vue (éventuellement triée et filtrée).
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueFilterObtient ou définit une méthode utilisée pour déterminer si un élément peut être inclus dans la vue.
Propriété publiqueGroupDescriptionsObtient une collection d'objets GroupDescription qui décrit comment les éléments de la collection sont regroupés dans la vue.
Propriété publiqueGroupsObtient une collection des groupes de niveau supérieur construite sur la base de la propriété GroupDescriptions.
Propriété publiqueIsCurrentAfterLastObtient une valeur qui indique si le CurrentItem de la vue se situe au-delà de la fin de la collection.
Propriété publiqueIsCurrentBeforeFirstObtient une valeur qui indique si le CurrentItem de la vue est avant le début de la collection.
Propriété protégéeIsCurrentInSyncObtient une valeur qui indique si CurrentItem est à la CurrentPosition.
Propriété protégéeIsDynamicObtient une valeur qui indique si la collection sous-jacente fournit des notifications de modification.
Propriété publiqueIsEmptyObtient une valeur qui indique si la vue (filtrée) résultante est vide.
Propriété publiqueIsInUseObtient une valeur qui indique si tout objet l'abonne aux événements de cet CollectionView.
Propriété protégéeIsRefreshDeferredObtient une valeur qui indique s'il y a un DeferRefresh en cours d'utilisation.
Propriété publiqueNeedsRefreshObtient une valeur qui indique si la vue doit être actualisée.
Propriété publiqueMembre statiqueNewItemPlaceholderObtient l'objet qui est dans la collection pour représenter un nouvel élément.
Propriété publiqueSortDescriptionsObtient une collection de structures SortDescription qui décrit comment les éléments dans la collection sont triés dans la vue.
Propriété publiqueSourceCollectionRetourne la collection non filtrée sous-jacente.
Propriété protégéeUpdatedOutsideDispatcherObtient 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).
Début
  NomDescription
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode protégéeClearChangeLog Obsolète. Efface toutes modifications en attente du journal des modifications.
Méthode protégéeClearPendingChangesDésactive modifié non-traité à la collection.
Méthode publiqueContainsRetourne une valeur qui indique si l'élément spécifié appartient à la vue.
Méthode publiqueDeferRefreshEntre un cycle différé que vous pouvez utiliser pour fusionner des modifications de la vue et retarder l'actualisation automatique.
Méthode publiqueDetachFromSourceCollectionSupprime la référence à la collection sous-jacente d'CollectionView.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode protégéeGetEnumeratorRetourne un objet que vous pouvez utiliser pour énumérer les éléments de la vue.
Méthode publiqueGetHashCodeSert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publiqueGetItemAtRécupère l'élément à l'index de base zéro spécifié dans la vue.
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueIndexOfRetourne l'index auquel l'élément spécifié est localisé.
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueMoveCurrentToDéfinit l'élément spécifié de façon à ce qu'il soit l'CurrentItem de la vue.
Méthode publiqueMoveCurrentToFirstDéfinit le premier élément de la vue comme le CurrentItem.
Méthode publiqueMoveCurrentToLastDéfinit le dernier élément de la vue comme le CurrentItem.
Méthode publiqueMoveCurrentToNextDéfinit l'élément qui suit le CurrentItem dans la vue comme le CurrentItem.
Méthode publiqueMoveCurrentToPositionDéfinit l'élément situé au niveau de l'index spécifié comme le CurrentItem de la vue.
Méthode publiqueMoveCurrentToPreviousDéfinit l'élément qui vient avant l'CurrentItem dans la vue en tant qu'CurrentItem.
Méthode protégéeOKToChangeCurrentRetourne une valeur qui indique si la vue peut changer d'élément CurrentItem.
Méthode protégéeOnAllowsCrossThreadChangesChangedSe produit lorsque la propriété AllowsCrossThreadChanges change.
Méthode protégéeOnBeginChangeLogging Obsolète. Appelée par la classe de base pour notifier la classe dérivée qu'un événement INotifyCollectionChanged.CollectionChanged a été publié à la file d'attente de messages.
Méthode protégéeOnCollectionChanged(NotifyCollectionChangedEventArgs)Déclenche l'événement CollectionChanged.
Méthode protégéeOnCollectionChanged(Object, NotifyCollectionChangedEventArgs)Déclenche l'événement CollectionChanged.
Méthode protégéeOnCurrentChangedDéclenche l'événement CurrentChanged.
Méthode protégéeOnCurrentChanging()Déclenche un événement CurrentChanging qui ne peut pas être annulé..
Méthode protégéeOnCurrentChanging(CurrentChangingEventArgs)Déclenche l'événement CurrentChanging à l'aide des arguments spécifiés.
Méthode protégéeOnPropertyChangedDéclenche l'événement PropertyChanged à l'aide des arguments spécifiés.
Méthode publiquePassesFilterRetourne une valeur qui indique si l'élément de la collection sous-jacente spécifié appartient à la vue.
Méthode protégéeProcessCollectionChangedEn cas de substitution dans une classe dérivée, traite une modification unique dans le thread d'interface utilisateur.
Méthode protégéeProcessPendingChangesGarantit que toutes les modifications en attente à la collection ont été validées.
Méthode publiqueRefreshRecrée la vue.
Méthode protégéeRefreshOrDeferActualise la vue ou spécifie que la vue doit être actualisée lorsque le cycle différé se termine.
Méthode protégéeRefreshOverrideRecrée la vue.
Méthode protégéeSetCurrent(Object, Int32)Définit l'élément et l'index spécifiés comme valeurs des propriétés CurrentItem et CurrentPosition.
Méthode protégéeSetCurrent(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.
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début
  NomDescription
Événement protégéCollectionChangedSe produit lorsque la vue a été modifiée.
Événement publicCurrentChangedSe produit après la modification de CurrentItem.
Événement publicCurrentChangingSe produit lorsque CurrentItem est en cours de modification.
Événement protégéPropertyChangedSe produit lorsqu'une valeur de la propriété a été modifiée.
Début
  NomDescription
Méthode d'extension publiqueAsParallelActive la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publiqueAsQueryableConvertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publiqueCast<TResult>Effectue un cast des éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publiqueOfType<TResult>Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début
  NomDescription
Implémentation d'interface expliciteMéthode privéeIEnumerable.GetEnumeratorRetourne un objet IEnumerator que vous pouvez utiliser pour énumérer les éléments de la vue.
Implémentation d'interface expliciteÉvénement privéINotifyCollectionChanged.CollectionChangedSe produit lorsque la vue a été modifiée.
Implémentation d'interface expliciteÉvénement privéINotifyPropertyChanged.PropertyChangedSe produit lorsqu'une valeur de propriété est modifiée.
Début

Vous ne devez pas créer d'objets de cette classe dans votre code. Pour créer une vue de collection pour une collection qui implémente uniquement IEnumerable, créez un objet CollectionViewSource, ajoutez votre collection à la propriété Source et obtenez la vue de collection à partir de la propriété View.

Une vue de collection peut être imaginée comme une couche posée sur la collection d'une source de liaison qui permet de naviguer dans la collection et de l'afficher selon des requêtes de tri, de filtrage et de regroupement, tout cela sans devoir manipuler la collection source sous-jacente. Si la collection de sources implémente l'interface INotifyCollectionChanged, les modifications qui déclenchent l'événement CollectionChanged sont propagées aux vues.

Parce qu'une vue ne modifie pas la collection de sources sous-jacente, plusieurs vues peuvent lui être associées. L'utilisation de vues vous permet d'afficher les mêmes données de différentes façons. Par exemple, vous pouvez utiliser deux vues pour une collection d'objets Task afin d'afficher des tâches triées par priorité sur une partie de la page et groupées par zone sur une autre partie de la page.

Dans les applications WPF, une vue de collection par défaut est associée à chaque collection. Plutôt que d'utiliser directement la collection, le moteur de liaison accède toujours à la collection via la vue associée. Pour obtenir la vue par défaut, utilisez la méthode CollectionViewSource.GetDefaultView. A la classe interne selon CollectionView est la vue par défaut pour les collections qui implémentent IEnumerableuniquement. ListCollectionView est la vue par défaut pour les collections qui implémentent IList. BindingListCollectionView est la vue par défaut pour les collections qui implémentent IBindingListView ou IBindingList.

Vous pouvez également créer une vue de votre collection en XAML (eXtensible Application Markup Language) à l'aide de la classe CollectionViewSource, puis lier votre contrôle à cette vue. La classe CollectionViewSource est la représentation XAML de la classe CollectionView. Pour obtenir un exemple, consultez Comment : trier et grouper des données à l'aide d'une vue en XAML.

Pour plus d'informations, consultez « Binding to Collections » (Liaisons de collections) dans Vue d'ensemble de la liaison de données.

Pour définir une vue dans XAML, utilisez la classe CollectionViewSource. CollectionViewSource est la représentation XAML de la classe CollectionView, et il expose les membres le plus communément utilisés de la classe CollectionView.

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
© 2013 Microsoft. Tous droits réservés.