Windows.Foundation.Collections Namespace

Definiert Standard-, spezialisierte und generische Auflistungsobjekte. Dies umfasst die IIterable<T>, IVector<T> und IMap<K,V> generische Schnittstellen, 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 Sammlung, auch bekannt als Karte oder ein Wörterbuch.

ValueSet

Implementiert eine Zuordnung mit Schlüsseln vom Typ String und Werten vom Typ Object. Objekt muss ein WinRT-PropertyValue- oder ValueSet sein. Als PropertyValue kann es sich um einen beliebigen Typ mit Ausnahme PropertyTypeInspectableArray. Diese Einschränkung besteht darin, sicherzustellen, dass der Wert serialisiert werden kann; wird von Einem Wert über eine Prozessgrenze übergeben.

Anmerkung

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.

.NET Diese Schnittstelle wird als System.Collections.Generic.IEnumerable<T>angezeigt. In jedem Fall, in dem ein Windows-Runtime-Typ IIterable<T>implementiert hat, kann .NET-Code stattdessen die APIs von IEnumerable<T> verwenden. C#-Code kann foreachverwenden, Visual Basic-Code kann For Each verwenden... Nächste. Alle .NET-Erweiterungsmethoden, die auf IEnumerable<T-> basieren und in .NET für UWP-Apps enthalten sind, sind barrierefrei (einschließlich der System.Linq--Erweiterungen, solange Sie den Namespace eingeschlossen haben).

IIterator<T>

Unterstützt einfache Iteration über eine Auflistung.

IKeyValuePair<K,V>

Stellt ein Schlüssel-Wert-Paar dar. Dies wird in der Regel als Einschränkungstyp verwendet, wenn Sie zwei Typparameter in einem Parameter kapseln müssen, um die Einschränkungen einer anderen generischen Schnittstelle zu erfüllen.

.NET Diese Schnittstelle wird als System.Collections.Generic.KeyValuePair<TKey,TValue> (eine Struktur, keine Schnittstelle) angezeigt. 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 Karte oder wörterbuch bezeichnet wird.

.NET Diese Schnittstelle erscheint .NET-Code als System.Collections.Generic.IDictionary<TKey,TValue> aufgrund der .NET-Sprachprojektion. 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.

.NET Diese Schnittstelle wird aufgrund der .NET-Sprachprojektion 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 dynamischer Änderungen an einer Karte, 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 korrelieren.

IVector<T>

Stellt eine Auflistung von Elementen mit wahlfreiem Zugriff dar.

.NET- Diese Schnittstelle erscheint .NET-Code als System.Collections.Generic.IList<T> aufgrund der .NET-Sprachprojektion. In jedem Fall, in dem 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 Ansicht in einem Vektor dar.

.NET- Diese Schnittstelle erscheint .NET-Code als System.Collections.Generic.IReadOnlyList<T-> aufgrund der .NET-Sprachprojektion. In jedem Fall, in dem ein Windows-Runtime-Typ IVectorView<T>implementiert hat, kann .NET-Code stattdessen die APIs von IReadOnlyList<T> verwenden.

Enumerationen

CollectionChange

Beschreibt die Aktion, die zu einer Änderung einer Auflistung führt.

Delegaten

MapChangedEventHandler<K,V>

Stellt die Methode dar, die das geänderte Ereignis einer observablen Zuordnung behandelt.

VectorChangedEventHandler<T>

Stellt die Methode dar, die das geänderte Ereignis eines observablen Vektors behandelt.

Hinweise

Viele der in diesem Namespace definierten Schnittstellen und Objekte weisen je nach verwendeter Programmiersprache unterschiedliche Sprachäquivalente auf. 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 Anmerkungen zu den spezifischen Typen, die in diesem Namespace definiert sind.

Weitere Informationen