IMapView<K,V> Schnittstelle

Definition

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3833646656, 41784, 19162, 173, 207, 39, 34, 114, 228, 140, 185)]
template <typename K, typename V>
struct IMapView : IIterable<IKeyValuePair<K, V>>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(3833646656, 41784, 19162, 173, 207, 39, 34, 114, 228, 140, 185)]
public interface IReadOnlyDictionary<K,V> : IEnumerable<KeyValuePair<K,V>>

Public Interface IReadOnlyDictionary(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.IReadOnlyDictionary<TKey,TValue-Schnittstelle> verwenden, wenn sie einen schreibgeschützten Karten-/Wörterbuchtyp implementieren möchten. In jedem Fall, wenn ein Windows-Runtime-Typ IMapView<K,V> implementiert hat, kann .NET-Code stattdessen die APIs von IReadOnlyDictionary<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 C++ aus einer C#- oder Visual Basic-App implementiert wurden.

Die IMapView<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 IMapView<K,V> unterstützen wörterbuchartige Funktionen, z. B. das Abrufen der Größe der Auflistung oder Nachschlagevorgänge, aber das Hinzufügen oder Entfernen von Elementen wird nicht unterstützt, da die Karte schreibgeschützt ist.

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.

Schnittstellenvererbung

IMapView erbt IIterable mithilfe einer IKeyValuePair-Einschränkung . Typen, die IMapView implementieren, implementieren auch die Schnittstellenmember von IKeyValuePair mit einer IKeyValuePair-Typeinschränkung . Auf ähnliche Weise wird bei Verwendung von .NET IEnumerable unterstützt. T>, mit seinem Einschränkungstyp als KeyValuePair , der denselben Schlüssel- und Werttyp wie die IReadOnlyDictionary<TKey,TValue-Implementierung> verwendet.

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• IReadOnlyDictionary< TKey,TValue>
• Sammlungen (C++/CX)