Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
CollectionView-Klasse
Stellt eine Ansicht zum Gruppieren, Sortieren, Filtern und Navigieren in einer Datenauflistung dar.
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Der CollectionView-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
CollectionView | Initialisiert eine neue Instanz der CollectionView-Klasse, die eine Ansicht der angegebenen Auflistung darstellt. |
| Name | Beschreibung | |
|---|---|---|
|
CanFilter | Ruft einen Wert ab, mit dem angegeben wird, ob diese Ansicht das Filtern unterstützt. |
|
CanGroup | Ruft einen Wert ab, mit dem angegeben wird, ob diese Ansicht das Gruppieren unterstützt. |
|
CanSort | Ruft einen Wert ab, mit dem angegeben wird, ob diese Ansicht das Sortieren unterstützt. |
|
Comparer | Gibt ein Objekt zurück, mit dem Sie die Elemente in der Ansicht vergleichen können. |
|
Count | Ruft die Anzahl der Datensätze in der Ansicht ab. |
|
Culture | Ruft die Kulturinformationen ab, die während der Sortierung verwendet werden sollen, oder legt diese Informationen fest. |
|
CurrentItem | Ruft das aktuelle Element in der Ansicht ab. |
|
CurrentPosition | Ruft die Ordinalposition des CurrentItem in der (optional sortierten und gefilterten) Ansicht ab. |
|
Dispatcher | Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.) |
|
Filter | Ruft die Methode ab, mit der bestimmt wird, ob ein Element in die Ansicht eingefügt werden kann, oder legt diese Methode fest. |
|
GroupDescriptions | Ruft eine Auflistung der GroupDescription-Objekte ab, in der das Gruppieren von Elementen in der Auflistung beschrieben wird. |
|
Groups | Ruft eine Auflistung der Gruppen der obersten Ebene ab, die auf der Grundlage der GroupDescriptions-Eigenschaft erstellt wird. |
|
IsCurrentAfterLast | Ruft einen Wert ab, mit dem angegeben wird, ob sich das CurrentItem der Ansicht hinter dem Ende der Auflistung befindet. |
|
IsCurrentBeforeFirst | Ruft einen Wert ab, mit dem angegeben wird, ob sich das CurrentItem der Ansicht vor dem Anfang der Auflistung befindet. |
|
IsCurrentInSync | Ruft einen Wert ab, mit dem angegeben wird, ob sich das CurrentItem an der CurrentPosition befindet. |
|
IsDynamic | Ruft einen Wert ab, mit dem angegeben wird, ob die zugrunde liegende Auflistung Änderungsbenachrichtigungen bereitstellt. |
|
IsEmpty | Ruft einen Wert ab, der angibt, ob die resultierende (gefilterte) Ansicht leer ist. |
|
IsRefreshDeferred | Ruft einen Wert ab, mit dem angegeben wird, ob ein ausstehender DeferRefresh vorhanden ist. |
|
NeedsRefresh | Ruft einen Wert ab, mit dem angegeben wird, ob die Ansicht aktualisiert werden muss. |
|
NewItemPlaceholder | Ruft das Objekt ab, das in der Auflistung ein neues Element darstellen soll. |
|
SortDescriptions | Ruft eine Auflistung der SortDescription-Strukturen ab, in der die Sortierung der Elemente in der Auflistung beschrieben wird. |
|
SourceCollection | Gibt die zugrunde liegende ungefilterte Auflistung zurück. |
|
UpdatedOutsideDispatcher | Ruft einen Wert ab, mit dem angegeben wird, ob eine Aktualisierung des Änderungsprotokolls erforderlich war, weil eine CollectionChanged-Benachrichtigung in einem anderen Thread empfangen wurde, ohne zuvor den user interface (UI)-Threadverteiler zu durchlaufen. |
| Name | Beschreibung | |
|---|---|---|
|
CheckAccess | Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.) |
|
ClearChangeLog | Löscht alle anstehenden Änderungen aus dem Änderungsprotokoll. |
|
Contains | Gibt einen Wert zurück, mit dem angegeben wird, ob das angegebene Element zur Ansicht gehört. |
|
DeferRefresh | Wechselt in eine Verzögerungsschleife, mit der Sie Änderungen in der Ansicht zusammenführen und die automatische Aktualisierung verzögern können. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
GetEnumerator | Gibt ein Objekt zurück, mit dem Sie die Elemente in der Ansicht auflisten können. |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetItemAt | Ruft das Element am angegebenen nullbasierten Index der Ansicht ab. |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
IndexOf | Gibt den Index zurück, bei dem sich das angegebene Element befindet. |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
MoveCurrentTo | Legt das angegebene Element als CurrentItem in der Ansicht fest. |
|
MoveCurrentToFirst | Legt das erste Element in der Ansicht als das CurrentItem fest. |
|
MoveCurrentToLast | Legt das letzte Element in der Ansicht als das CurrentItem fest. |
|
MoveCurrentToNext | Legt das Element nach dem CurrentItem in der Ansicht als das CurrentItem fest. |
|
MoveCurrentToPosition | Legt das Element am angegebenen Index als das CurrentItem in der Ansicht fest. |
|
MoveCurrentToPrevious | Legt das Element vor dem CurrentItem in der Ansicht als das CurrentItem fest. |
|
OKToChangeCurrent | Gibt einen Wert zurück, mit dem angegeben wird, ob die Ansicht das CurrentItem-Element ändern kann. |
|
OnBeginChangeLogging | Wird von der Basisklasse aufgerufen, um die abgeleitete Klasse zu benachrichtigen, dass ein INotifyCollectionChanged.CollectionChanged-Ereignis an die Meldungswarteschlange gesendet wurde. |
|
OnCollectionChanged(NotifyCollectionChangedEventArgs) | Löst das CollectionChanged-Ereignis aus. |
|
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs) | Löst das CollectionChanged-Ereignis aus. |
|
OnCurrentChanged | Löst das CurrentChanged-Ereignis aus. |
|
OnCurrentChanging() | Löst ein CurrentChanging-Ereignis aus, das nicht abgebrochen werden kann. |
|
OnCurrentChanging(CurrentChangingEventArgs) | Löst das CurrentChanging-Ereignis mit den angegebenen Argumenten aus. |
|
OnPropertyChanged | Löst das PropertyChanged-Ereignis mit den angegebenen Argumenten aus. |
|
PassesFilter | Gibt einen Wert zurück, mit dem angegeben wird, ob das angegebene Element zur Ansicht in der zugrunde liegenden Auflistung gehört. |
|
ProcessCollectionChanged | Wenn eine Überschreibung in einer abgeleiteten Klasse erfolgt, wird eine einzelne Änderung im UI-Thread verarbeitet. |
|
Refresh | Erstellt die Ansicht neu. |
|
RefreshOrDefer | Aktualisiert die Ansicht oder gibt an, dass die Ansicht aktualisiert werden muss, sobald der Verzögerungszyklus abgeschlossen ist. |
|
RefreshOverride | Erstellt die Ansicht neu. |
|
SetCurrent(Object, Int32) | Legt das angegebene Element und den angegebenen Index als Werte der CurrentItem-Eigenschaft und der CurrentPosition-Eigenschaft fest. |
|
SetCurrent(Object, Int32, Int32) | Legt das angegebene Element und den angegebenen Index als Werte der CurrentItem-Eigenschaft und der CurrentPosition-Eigenschaft fest. Diese Methode kann im Konstruktor einer abgeleiteten Klasse aufgerufen werden. |
|
ToString | Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.) |
|
VerifyAccess | Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
CollectionChanged | Tritt ein, wenn die Ansicht geändert wurde. |
|
CurrentChanged | Tritt ein, nachdem sich das CurrentItem geändert hat. |
|
CurrentChanging | Tritt ein, wenn das CurrentItem geändert wird. |
|
PropertyChanged | Tritt ein, wenn sich ein Eigenschaftswert geändert hat. |
| Name | Beschreibung | |
|---|---|---|
|
AsParallel | Ermöglicht die Parallelisierung einer Abfrage. (Durch ParallelEnumerable definiert.) |
|
AsQueryable | Konvertiert einen IEnumerable in einen IQueryable. (Durch Queryable definiert.) |
|
Cast<TResult> | Konvertiert die Elemente eines IEnumerable in den angegebenen Typ. (Durch Enumerable definiert.) |
|
OfType<TResult> | Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs. (Durch Enumerable definiert.) |
| Name | Beschreibung | |
|---|---|---|
|
IEnumerable.GetEnumerator | Gibt ein IEnumerator-Objekt zurück, mit dem Sie die Elemente in der Ansicht auflisten können. |
|
INotifyCollectionChanged.CollectionChanged | Tritt ein, wenn die Ansicht geändert wurde. |
|
INotifyPropertyChanged.PropertyChanged | Tritt ein, wenn sich ein Eigenschaftswert ändert. |
Sie sollten keine Objekte dieser Klasse im Code erstellen. Zum Erstellen einer Auflistungsansicht für eine Auflistung, die nur IEnumerable implementiert, erstellen Sie ein CollectionViewSource-Objekt, fügen Sie die Auflistung der Source-Eigenschaft hinzu, und rufen Sie die Auflistungsansicht von der View-Eigenschaft ab.
Eine Auflistungsansicht fungiert als Ebene über einer Bindungsquellen-Auflistung, in der Sie mit Sortier-, Filter- und Gruppierungsabfragen navigieren und die jeweilige Auflistung anzeigen können, ohne die zugrunde liegende Quellauflistung selbst ändern zu müssen. Wenn die Quellauflistung die INotifyCollectionChanged-Schnittstelle implementiert, werden die vom CollectionChanged-Ereignis ausgelösten Änderungen an die Ansichten weitergegeben.
Da in einer Ansicht die zugrunde liegende Quellauflistung nicht geändert wird, können einer Quellauflistung mehrere Ansichten zugeordnet sein. Mit Ansichten können Sie die gleichen Daten auf verschiedene Weise anzeigen. Beispielsweise können Sie in zwei Ansichten einer Auflistung von Task-Objekten Aufgaben in einem Teil der Seite nach Priorität sortiert und in einem anderen Teil der Seite nach Bereich gruppiert anzeigen.
In WPF-Anwendungen ist allen Auflistungen eine Standardauflistungsansicht zugeordnet. Im Bindungsmodul erfolgt der Zugriff auf die Auflistung nicht direkt, sondern stets über die zugeordnete Ansicht. Um die Standardansicht zu erhalten, rufen Sie die CollectionViewSource.GetDefaultView auf. Eine interne, auf CollectionView basierende Klasse ist die Standardansicht für Auflistungen, die IEnumerable implementieren. ListCollectionView ist die Standardansicht für Auflistungen, die IList implementieren. BindingListCollectionView ist die Standardansicht für Auflistungen, die IBindingListView oder IBindingList implementieren.
Alternativ dazu können Sie eine Ansicht der Auflistung in Extensible Application Markup Language (XAML) mit der CollectionViewSource-Klasse erstellen und dann das Steuerelement an diese Ansicht binden. Die CollectionViewSource-Klasse ist die XAML-Darstellung der CollectionView-Klasse. Ein Beispiel finden Sie unter Gewusst wie: Sortieren und Gruppieren von Daten mit einer Ansicht in XAML.
Weitere Informationen finden Sie in Übersicht über Datenbindung unter Binden an Auflistungen
Eine Ansicht in XAML legen Sie mit der CollectionViewSource-Klasse fest. CollectionViewSource ist die XAML-Darstellung der CollectionView-Klasse, und es werden die am häufigsten verwendeten Member der CollectionView-Klasse offengelegt.
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.