IMapView<K,V> Interface

Définition

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

Attributs

ContractVersionAttribute GuidAttribute

Implémente

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

Configuration requise pour Windows

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

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

Méthodes

S’applique à

Voir aussi

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