Freigeben über


IMapView<K,V> Schnittstelle

Definition

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, wenn ein Windows-Runtime-Typ IMapView<K,V> implementiert hat, kann .NET-Code stattdessen die APIs von IReadOnlyDictionary<TKey,TValue> verwenden.

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

K
V
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (eingeführt in v1.0)

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

Hinweis

Erweiterungsfunktionen sind für die C++/WinRT-Projektionstypen für bestimmte Windows-Runtime-APIs vorhanden. Winrt::Windows::Foundation::IAsyncAction ist beispielsweise der C++/WinRT-Projektionstyp für IAsyncAction. Die Erweiterungsfunktionen sind nicht Teil der ABI-Oberfläche (Application Binary Interface) der tatsächlichen Windows-Runtime-Typen, daher werden sie nicht als Member der Windows-Runtime-APIs aufgeführt. Sie können sie jedoch in jedem C++/WinRT-Projekt aufrufen. Weitere Informationen finden Sie unter C++/WinRT-Funktionen, die Windows-Runtime-APIs erweitern.

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

Size

Ruft die Anzahl der Elemente in der Karte ab.

Methoden

HasKey(K)

Bestimmt, ob die Kartenansicht den angegebenen Schlüssel enthält.

Lookup(K)

Gibt das Element am angegebenen Schlüssel in der Kartenansicht zurück.

Split(IMapView<K,V>, IMapView<K,V>)

Unterteilt die Kartenansicht in zwei Ansichten.

Gilt für:

Weitere Informationen