IMapView<K,V> Interface

Définition

Espace de noms:

Windows.Foundation.Collections

Représente une vue immuable dans une carte.

.NET Cette interface apparaît sous la forme System.Collections.Generic.IReadOnlyDictionary<TKey,TValue> en raison de la projection du langage .NET. Dans tous les cas où un type Windows Runtime a implémenté IMapView<K,V>, le code .NET peut utiliser les API de IReadOnlyDictionary<TKey,TValue> à la place.

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))

Paramètres de type

K

V

Attributs

ContractVersionAttribute GuidAttribute

Implémente

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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (introduit dans v1.0)

Remarques

Lors de la programmation avec .NET, cette interface est masquée et les développeurs doivent utiliser l’interface System.Collections.Generic.IReadOnlyDictionary<TKey,TValue> s’ils veulent implémenter un type de carte/dictionnaire en lecture seule. Dans tous les cas où un type Windows Runtime a implémenté IMapView<K,V>, le code .NET peut utiliser les API de IReadOnlyDictionary<TKey,TValue> à la place. Cela inclut toutes les API Windows Runtime existantes ainsi que des scénarios tels que l’utilisation des API de Windows Runtime composants implémentés à l’origine en C++ à partir d’une application C# ou Visual Basic.

L’interface IMapView<K,V> représente une collection de paires clé-valeur où une valeur est accessible par sa clé associée. Les propriétés et méthodes d’IMapView<K,V> prennent en charge les fonctionnalités de type dictionnaire, telles que l’obtention de la taille de la collection ou des recherches, mais ne prennent pas en charge l’ajout ou la suppression d’éléments, car la carte est en lecture seule.

Fonctions d’extension C++/WinRT

Notes

Des fonctions d’extension existent sur les types de projection C++/WinRT pour certaines API Windows Runtime. Par exemple, winrt ::Windows ::Foundation ::IAsyncAction est le type de projection C++/WinRT pour IAsyncAction. Les fonctions d’extension ne font pas partie de la surface d’interface binaire d’application (ABI) des types Windows Runtime réels. Elles ne sont donc pas répertoriées en tant que membres des API Windows Runtime. Mais vous pouvez les appeler à partir de n’importe quel projet C++/WinRT. Consultez Fonctions C++/WinRT qui étendent Windows Runtime API.

auto begin() const;

Retourne un itérateur à la première paire clé-valeur de la collection, à utiliser dans des algorithmes C++, tels que des boucles basées sur for une plage.

auto end() const;

Retourne un itérateur à un passé de la dernière paire clé-valeur de la collection, à utiliser dans des algorithmes C++, tels que des boucles basées sur for une plage.

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

Tente de rechercher un élément dans la carte avec la clé. Pour les types de référence, retourne la valeur si elle est trouvée ou nullptr si elle n’est pas trouvée. Pour les types valeur, retourne une valeur std ::optional<V>, qui contient la valeur si elle est trouvée, ou qui n’a aucune valeur si elle n’est pas trouvée.

Héritage de l'interface

IMapView hérite d’IIterable, à l’aide d’une contrainte IKeyValuePair . Les types qui implémentent IMapView implémentent également les membres d’interface de IKeyValuePair, avec une contrainte de type IKeyValuePair . De même, si vous utilisez .NET, il existe une prise en charge d’IEnumerable ; T>, avec son type de contrainte en tant que KeyValuePair qui utilise les mêmes types de clé et de valeur que l’implémentation IReadOnlyDictionary<TKey,TValue> .

Propriétés

Size	Obtient le nombre d’éléments dans la carte.

Méthodes

HasKey(K)	Détermine si la vue cartographique contient la clé spécifiée.
Lookup(K)	Retourne l’élément à la clé spécifiée dans la vue cartographique.
Split(IMapView<K,V>, IMapView<K,V>)	Fractionne la vue de carte en deux vues.

Voir aussi

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