Windows.Foundation.Collections Namespace

Referenz

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Definiert standardmäßige, spezialisierte und generische Auflistungsobjekte. Dazu gehören die generischen Schnittstellen IIterable<T>, IVector<T> und IMap<K,V>, die als Muster für die grundlegende Sammlungsunterstützung in der gesamten Windows-Runtime-API verwendet werden.

Klassen

PropertySet	Stellt einen Eigenschaftensatz dar, bei dem es sich um einen Satz von PropertyValue-Objekten mit Zeichenfolgenschlüsseln handelt.
StringMap	Eine assoziative Auflistung, auch als Karte oder Wörterbuch bezeichnet.
ValueSet	Implementiert eine Zuordnung mit Schlüsseln vom Typ String und Werten des Typs Object. Das Objekt muss ein WinRT PropertyValue oder ValueSet sein. Als PropertyValue kann es sich um einen beliebigen Typ mit Ausnahme von PropertyTypeInspectableArray handeln. Diese Einschränkung besteht, um sicherzustellen, dass der Wert serialisiert werden kann. wird als Wert über eine Prozessgrenze übergeben. Hinweis Einige Member sind nur für die angegebene Sprache verfügbar.

Schnittstellen

IIterable<T>	Macht einen Iterator verfügbar, der eine einfache Iteration über eine Auflistung eines angegebenen Typs unterstützt. .NETTO Diese Schnittstelle wird als System.Collections.Generic.IEnumerable<T> angezeigt. In jedem Fall, wenn ein Windows-Runtime Typ IIterable<T> implementiert hat, kann .NET-Code stattdessen die APIs von IEnumerable<T> verwenden. C#-Code kann foreach verwenden, Visual Basic-Code kann For Each verwenden... Als Nächstes. Alle .NET-Erweiterungsmethoden, die auf IEnumerable<T> basieren und in .NET für UWP-Apps enthalten sind, sind zugänglich (einschließlich der System.Linq-Erweiterungen , sofern Sie den Namespace eingeschlossen haben).
IIterator<T>	Unterstützt einfache Iterationen über eine Sammlung.
IKeyValuePair<K,V>	Stellt ein Schlüssel-Wert-Paar dar. Dies wird in der Regel als Einschränkungstyp verwendet, wenn Sie zwei Typparameter in einen Typ kapseln müssen, um die Einschränkungen einer anderen generischen Schnittstelle zu erfüllen. .NETTO Diese Schnittstelle wird als System.Collections.Generic.KeyValuePair<TKey,TValue> angezeigt (eine Struktur, keine Schnittstelle). In jedem Fall, in dem ein Windows-Runtime Typ IKeyValuePair<K,V> implementiert hat, kann .NET-Code stattdessen die APIs von KeyValuePair verwenden.
IMap<K,V>	Stellt eine assoziative Auflistung dar, die auch als Zuordnung oder Wörterbuch bezeichnet wird. .NETTO Diese Schnittstelle wird für .NET-Code aufgrund der .NET-Sprachprojektionierung als System.Collections.Generic.IDictionary<TKey,TValue> angezeigt. In jedem Fall, in dem ein Windows-Runtime Typ IMap<K,V> implementiert hat, kann .NET-Code stattdessen die APIs von IDictionary<TKey,TValue> verwenden.
IMapChangedEventArgs<K>	Stellt Daten für das geänderte Ereignis einer Kartensammlung bereit.
IMapView<K,V>	Stellt eine unveränderliche Ansicht in einer Karte dar. .NETTO Diese Schnittstelle wird aufgrund der .NET-Sprachprojektionierung als System.Collections.Generic.IReadOnlyDictionary<TKey,TValue> angezeigt. In jedem Fall, in dem ein Windows-Runtime Typ IMapView<K,V> implementiert hat, kann .NET-Code stattdessen die APIs von IReadOnlyDictionary<TKey,TValue> verwenden.
IObservableMap<K,V>	Benachrichtigt Listener über dynamische Änderungen an einer Zuordnung, z. B. wenn Elemente hinzugefügt oder entfernt werden.
IObservableVector<T>	Benachrichtigt Listener über Änderungen am Vektor.
IPropertySet	Stellt eine Auflistung von Schlüssel-Wert-Paaren dar, die mehrere andere Auflistungsschnittstellen korreliert.
IVector<T>	Stellt eine Auflistung von Elementen mit zufälligem Zugriff dar. .NETTO Diese Schnittstelle wird für .NET-Code aufgrund der .NET-Sprachprojektion als System.Collections.Generic.IList<T> angezeigt. In jedem Fall, wenn ein Windows-Runtime Typ IVector<T> implementiert hat, kann .NET-Code stattdessen die APIs von IList<T> verwenden.
IVectorChangedEventArgs	Stellt Daten für das geänderte Ereignis eines Vektors bereit.
IVectorView<T>	Stellt eine unveränderliche Sicht in einen Vektor dar. .NETTO Diese Schnittstelle wird für .NET-Code aufgrund der .NET-Sprachprojektion als System.Collections.Generic.IReadOnlyList<T> angezeigt. In jedem Fall, wenn ein Windows-Runtime Typ IVectorView<T> implementiert hat, kann .NET-Code stattdessen die APIs von IReadOnlyList<T> verwenden.

Enumerationen

CollectionChange

Beschreibt die Aktion, die eine Änderung an einer Sammlung verursacht.

Delegaten

MapChangedEventHandler<K,V>	Stellt die Methode dar, die das geänderte Ereignis einer beobachtbaren Zuordnung behandelt.
VectorChangedEventHandler<T>	Stellt die Methode dar, die das geänderte Ereignis eines beobachtbaren Vektors behandelt.

Hinweise

Viele der in diesem Namespace definierten Schnittstellen und Objekte verfügen je nach verwendeter Programmiersprache über unterschiedliche Sprachäquivalente. Weitere Informationen zur Verwendung dieser Schnittstellen aus C++-Code finden Sie unter Collections (C++/CX). Weitere Informationen zur Verwendung von Sammlungstypen aus .NET-Code finden Sie in den Hinweisen in den spezifischen Typen, die in diesem Namespace definiert sind.