IMap<K,V> Interface

Définition

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

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.IDictionary<TKey,TValue> s’ils veulent implémenter un type map/dictionary. Dans tous les cas où un type Windows Runtime a implémenté IMap<K,V>, le code .NET peut utiliser les API de IDictionary<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 dans les extensions de composants Visual C++ (C++/CX) à partir d’une application C# ou Visual Basic.

L’interface IMap<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’IMap<K,V> prennent en charge les fonctionnalités de type dictionnaire, telles que l’obtention de la taille de la collection et l’ajout et la suppression d’éléments à des emplacements spécifiés dans la collection. En outre, la méthode GetView fournit une instantané de la carte dont l’état observable ne change pas. Le instantané est utile lorsque vous avez besoin d’une vue de la collection à laquelle faire référence dans les opérations suivantes qui impliquent IMap<K,V>.

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.

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

Supprime l’élément dans la carte avec la clé, le cas échéant. Retourne true si l’élément a été trouvé et supprimé. Retourne false si l’élément est introuvable.

Héritage de l'interface

IMap<K,V> hérite d’IIterable, à l’aide d’une contrainte IKeyValuePair qui utilise les mêmes types de clé et de valeur. Les types qui implémentent IMap<K,V> implémentent également les membres d’interface d’IIterable, avec la contrainte de type IKeyValuePair partageant la même clé et la même valeur. De même, si vous utilisez .NET, il existe une prise en charge de IEnumerabe<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 IDictionary<TKey,TValue> .

Propriétés

Méthodes

S’applique à

Voir aussi

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