IMapView<K,V> Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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. |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour