IMap<K,V> Schnittstelle

Definition

public interface class IMap : IIterable<IKeyValuePair<K, V> ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1009329662, 34073, 17857, 170, 121, 25, 123, 103, 24, 193, 193)]
template <typename K, typename V>
struct IMap : IIterable<IKeyValuePair<K, V>>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(1009329662, 34073, 17857, 170, 121, 25, 123, 103, 24, 193, 193)]
public interface IDictionary<K,V> : IEnumerable<KeyValuePair<K,V>>

Public Interface IDictionary(Of K, V)
Implements IEnumerable(Of KeyValuePair(Of K, V))

Typparameter

Attribute

ContractVersionAttribute GuidAttribute

Implementiert

IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>>

Windows-Anforderungen

Hinweise

Beim Programmieren mit .NET ist diese Schnittstelle ausgeblendet, und Entwickler sollten die System.Collections.Generic.IDictionary<TKey,TValue-Schnittstelle> verwenden, wenn sie einen Zuordnungs-/Wörterbuchtyp implementieren möchten. In jedem Fall, wenn ein Windows-Runtime-Typ IMap<K,V> implementiert hat, kann .NET-Code stattdessen die APIs von IDictionary<TKey,TValue> verwenden. Dies umfasst alle vorhandenen Windows-Runtime-API sowie Szenarien wie die Verwendung der APIs von Windows-Runtime Komponenten, die ursprünglich in Visual C++-Komponentenerweiterungen (C++/CX) aus einer C#- oder Visual Basic-App implementiert wurden.

Die IMap<K,V-Schnittstelle> stellt eine Sammlung von Schlüssel-Wert-Paaren dar, auf die mit dem zugeordneten Schlüssel auf einen Wert zugegriffen werden kann. Eigenschaften und Methoden von IMap<K,V> unterstützen wörterbuchartige Funktionen, z. B. das Abrufen der Größe der Auflistung und das Hinzufügen und Entfernen von Elementen an angegebenen Speicherorten in der Auflistung. Darüber hinaus stellt die GetView-Methode eine Momentaufnahme der Karte bereit, deren beobachtbarer Zustand sich nicht ändert. Die Momentaufnahme ist nützlich, wenn Sie eine Ansicht der Auflistung benötigen, auf die in nachfolgenden Vorgängen verwiesen werden soll, die IMap<K,V> umfassen.

C++/WinRT-Erweiterungsfunktionen

auto begin() const;

Gibt einen Iterator für das erste Schlüssel-Wert-Paar der Auflistung zur Verwendung in C++-Algorithmen zurück, z. B. bereichsbasierte for Schleifen.

auto end() const;

Gibt einen Iterator nach dem letzten Schlüssel-Wert-Paar der Auflistung für die Verwendung in C++-Algorithmen zurück, z. B. bereichsbasierte for Schleifen.

auto TryLookup(param_type<K> const& key) const;

Versucht, ein Element in der Karte mit dem Schlüssel nachzuschlagen. Gibt für Verweistypen den Wert zurück, wenn er gefunden oder nullptr nicht gefunden wurde. Für Werttypen gibt eine std::optional<V> zurück, die den Wert enthält, wenn sie gefunden wurde, oder keinen Wert hat, falls nicht gefunden.

bool TryRemove(param_type<K> const& key) const;

Entfernt das Element in der Karte mit dem Schlüsselschlüssel, falls vorhanden. Gibt zurück true , wenn das Element gefunden und entfernt wurde. Gibt zurück false , wenn das Element nicht gefunden wurde.

Schnittstellenvererbung

IMap<K,V> erbt IIterable unter Verwendung einer IKeyValuePair-Einschränkung , die denselben Schlüssel- und Werttyp verwendet. Typen, die IMap<K,V> implementieren, implementieren auch die Schnittstellenmember von IIterable, wobei die IKeyValuePair-Typeinschränkung denselben Schlüssel und Wert gemeinsam nutzen. Auf ähnliche Weise wird bei Verwendung von .NET IEnumerabe<T> unterstützt, dessen Einschränkungstyp als KeyValuePair denselben Schlüssel- und Werttyp verwendet wie die IDictionary<TKey,TValue-Implementierung> .

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Sammlungen (C++/CX)
• System.Collections.Generic.IDictionary< TKey,TValue>