CollectionView Třída

Definice

Obor názvů:

System.Windows.Data

Sestavení:

PresentationFramework.dll

Představuje zobrazení pro seskupení, řazení, filtrování a navigaci v kolekci dat.

public ref class CollectionView : System::Windows::Threading::DispatcherObject, System::Collections::IEnumerable, System::Collections::Specialized::INotifyCollectionChanged, System::ComponentModel::ICollectionView, System::ComponentModel::INotifyPropertyChanged

public class CollectionView : System.Windows.Threading.DispatcherObject, System.Collections.IEnumerable, System.Collections.Specialized.INotifyCollectionChanged, System.ComponentModel.ICollectionView, System.ComponentModel.INotifyPropertyChanged

type CollectionView = class
    inherit DispatcherObject
    interface IEnumerable
    interface INotifyCollectionChanged
    interface ICollectionView
    interface INotifyPropertyChanged

Public Class CollectionView
Inherits DispatcherObject
Implements ICollectionView, IEnumerable, INotifyCollectionChanged, INotifyPropertyChanged

Dědičnost

Object

DispatcherObject

CollectionView

Odvozené

System.Windows.Controls.ItemCollection

System.Windows.Data.BindingListCollectionView

System.Windows.Data.ListCollectionView

Implementuje

IEnumerable INotifyCollectionChanged ICollectionView INotifyPropertyChanged

Poznámky

V kódu byste neměli vytvářet objekty této třídy. Chcete-li vytvořit zobrazení kolekce pro kolekci, která pouze implementuje IEnumerable, vytvořte CollectionViewSource objekt, přidejte kolekci do Source vlastnosti a získejte zobrazení kolekce z View vlastnosti .

Zobrazení kolekce si můžete představit jako vrstvu nad zdrojovou kolekcí vazby, která umožňuje procházet a zobrazovat kolekci na základě dotazů řazení, filtrování a seskupení, aniž byste museli manipulovat se samotnou podkladovou zdrojovou kolekcí. Pokud zdrojová kolekce implementuje INotifyCollectionChanged rozhraní, změny, které vyvolávají CollectionChanged událost, se rozšíří do zobrazení.

Vzhledem k tomu, že zobrazení nemění podkladovou zdrojovou kolekci, může mít zdrojová kolekce přidružené více zobrazení. Pomocí zobrazení můžete stejná data zobrazit různými způsoby. Můžete například použít dvě zobrazení v kolekci Task objektů k zobrazení úkolů seřazených podle priority na jedné části stránky a seskupených podle oblasti v jiné části stránky.

V aplikacích WPF mají všechny kolekce přidružené výchozí zobrazení kolekce. Místo přímé práce s kolekcí modul vazeb vždy přistupuje ke kolekci prostřednictvím přidruženého zobrazení. K získání výchozího zobrazení použijte metodu CollectionViewSource.GetDefaultView . Interní třída založená na CollectionView je výchozím zobrazením pro kolekce, které implementují pouze IEnumerable. ListCollectionView je výchozí zobrazení pro kolekce, které implementují IList. BindingListCollectionView je výchozí zobrazení pro kolekce, které implementují IBindingListView nebo IBindingList.

Případně můžete vytvořit zobrazení vaší kolekce v jazyce XAML (Extensible Application Markup Language) pomocí CollectionViewSource třídy a pak svázat ovládací prvek s tímto zobrazením. Třída CollectionViewSource je reprezentace CollectionView XAML třídy. Příklad najdete v tématu Postupy: Řazení a seskupení dat pomocí zobrazení v XAML.

Další informace najdete v tématu Vazba na kolekce v přehledu datových vazeb.

Pokud chcete nastavit zobrazení v XAML, použijte CollectionViewSource třídu . CollectionViewSource je reprezentace CollectionView XAML třídy a zveřejňuje nejčastěji používané členy CollectionView třídy.

Konstruktory

CollectionView(IEnumerable)

Inicializuje novou instanci CollectionView třídy, která představuje zobrazení zadané kolekce.

Vlastnosti

AllowsCrossThreadChanges	Získá hodnotu, která označuje, zda jiné vlákno než ten, který vytvořil CollectionView může změnit SourceCollection.
CanFilter	Získá hodnotu, která označuje, zda zobrazení podporuje filtrování.
CanGroup	Získá hodnotu, která označuje, zda zobrazení podporuje seskupení.
CanSort	Získá hodnotu, která označuje, zda zobrazení podporuje řazení.
Comparer	Vrátí objekt, který můžete použít k porovnání položek v zobrazení.
Count	Získá počet záznamů v zobrazení.
Culture	Získá nebo nastaví informace o jazykové verzi, které se mají použít při řazení.
CurrentItem	Získá aktuální položku v zobrazení.
CurrentPosition	Získá řadovou CurrentItem pozici v rámci (volitelně seřazené a filtrované) zobrazení.
Dispatcher	Získá přidruženou Dispatcher k tomuto DispatcherObject . (Zděděno od DispatcherObject)
Filter	Získá nebo nastaví metodu používanou k určení, zda je položka vhodná pro zahrnutí v zobrazení.
GroupDescriptions	Získá kolekci GroupDescription objektů, která popisuje, jak jsou položky v kolekci seskupené v zobrazení.
Groups	Získá kolekci skupin nejvyšší úrovně, která je vytvořena na GroupDescriptions základě vlastnosti.
IsCurrentAfterLast	Získá hodnotu, která označuje, zda CurrentItem zobrazení je za koncem kolekce.
IsCurrentBeforeFirst	Získá hodnotu, která označuje, zda CurrentItem zobrazení je před začátkem kolekce.
IsCurrentInSync	Získá hodnotu, která označuje, zda CurrentItem je na CurrentPosition.
IsDynamic	Získá hodnotu, která označuje, zda podkladová kolekce poskytuje oznámení o změnách.
IsEmpty	Získá hodnotu, která označuje, zda je výsledné (filtrované) zobrazení prázdné.
IsInUse	Získá hodnotu, která označuje, zda se některý objekt přihlásit k odběru událostí tohoto CollectionViewobjektu .
IsRefreshDeferred	Získá hodnotu, která označuje, zda se používá nevyužitý DeferRefresh() .
NeedsRefresh	Získá hodnotu, která označuje, zda zobrazení je třeba aktualizovat.
NewItemPlaceholder	Získá objekt, který je v kolekci reprezentovat novou položku.
SortDescriptions	Získá kolekci SortDescription struktur, která popisuje, jak jsou položky v kolekci seřazeny v zobrazení.
SourceCollection	Vrátí základní nefiltrovanou kolekci.
UpdatedOutsideDispatcher	Získá hodnotu, která označuje, zda bylo nutné aktualizovat protokol změn, protože CollectionChanged oznámení byl přijat v jiném vlákně bez prvního vstupu do uživatelského rozhraní (UI) vlákno dispečera.

Metody

CheckAccess()	Určuje, zda má volající vlákno přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearChangeLog()	Zastaralé. Vymaže všechny čekající změny z protokolu změn.
ClearPendingChanges()	Vymaže nezpracované změny v kolekci.
Contains(Object)	Vrátí hodnotu, která označuje, zda zadaná položka patří do zobrazení.
DeferRefresh()	Zadá cyklus odložení, který můžete použít ke sloučení změn zobrazení a zpoždění automatické aktualizace.
DetachFromSourceCollection()	Odebere odkaz na podkladovou kolekci z objektu CollectionView.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Vrátí objekt, který můžete použít k vytvoření výčtu položek v zobrazení.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetItemAt(Int32)	Načte položku v zadaném indexu založeném na nule v zobrazení.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IndexOf(Object)	Vrátí index, ve kterém se nachází zadaná položka.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MoveCurrentTo(Object)	Nastaví zadanou položku na hodnotu v CurrentItem zobrazení.
MoveCurrentToFirst()	Nastaví první položku v zobrazení na CurrentItem.
MoveCurrentToLast()	Nastaví poslední položku v zobrazení na CurrentItem.
MoveCurrentToNext()	Nastaví položku za položkou CurrentItem v zobrazení na CurrentItem.
MoveCurrentToPosition(Int32)	Nastaví položku v zadaném indexu na hodnotu CurrentItem v zobrazení.
MoveCurrentToPrevious()	Nastaví položku před objektem CurrentItem v zobrazení na CurrentItem.
OKToChangeCurrent()	Vrátí hodnotu, která označuje, jestli zobrazení může změnit, která položka je CurrentItem.
OnAllowsCrossThreadChangesChanged()	Nastane při AllowsCrossThreadChanges změně vlastnosti.
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Zastaralé. Volá se základní třída, která má upozornit odvozenou CollectionChanged třídu, že událost byla odeslána do fronty zpráv.
OnCollectionChanged(NotifyCollectionChangedEventArgs)	CollectionChanged Vyvolá událost.
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	CollectionChanged Vyvolá událost.
OnCurrentChanged()	CurrentChanged Vyvolá událost.
OnCurrentChanging()	CurrentChanging Vyvolá událost, kterou nelze zrušit.
OnCurrentChanging(CurrentChangingEventArgs)	Vyvolá událost se CurrentChanging zadanými argumenty.
OnPropertyChanged(PropertyChangedEventArgs)	PropertyChanged Vyvolá událost pomocí zadaných argumentů.
PassesFilter(Object)	Vrátí hodnotu, která označuje, zda zadaná položka v podkladové kolekci patří do zobrazení.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	Při přepsání v odvozené třídě zpracuje jednu změnu ve vlákně uživatelského rozhraní.
ProcessPendingChanges()	Zajišťuje, aby byly potvrzeny všechny čekající změny kolekce.
Refresh()	Znovu vytvoří zobrazení.
RefreshOrDefer()	Aktualizuje zobrazení nebo určuje, že je potřeba ho aktualizovat po dokončení cyklu odložení.
RefreshOverride()	Znovu vytvoří zobrazení.
SetCurrent(Object, Int32)	Nastaví zadanou položku a index jako hodnoty CurrentItem vlastností a CurrentPosition .
SetCurrent(Object, Int32, Int32)	Nastaví zadanou položku a index jako hodnoty CurrentItem vlastností a CurrentPosition . Tuto metodu lze volat z konstruktoru odvozené třídy.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
VerifyAccess()	Vynutí, aby volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)

Událost

CollectionChanged	Nastane, když se zobrazení změnilo.
CurrentChanged	Nastane po CurrentItem změně.
CurrentChanging	Nastane, když se CurrentItem mění.
PropertyChanged	Nastane při změně hodnoty vlastnosti.

Explicitní implementace rozhraní

IEnumerable.GetEnumerator()	IEnumerator Vrátí objekt, který můžete použít k vytvoření výčtu položek v zobrazení.
INotifyCollectionChanged.CollectionChanged	Nastane, když se zobrazení změnilo.
INotifyPropertyChanged.PropertyChanged	Nastane při změně hodnoty vlastnosti.

Metody rozšíření