IMapView<K,V> Interfaccia

Definizione

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

Parametri di tipo

Attributi

ContractVersionAttribute GuidAttribute

Implementazioni

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

Requisiti Windows

Commenti

Quando si esegue la programmazione con .NET, questa interfaccia è nascosta e gli sviluppatori devono usare l'interfaccia System.Collections.Generic.IReadOnlyDictionary<TKey,TValue> se vogliono implementare un tipo mappa/dizionario di sola lettura. In tutti i casi in cui un Windows Runtime tipo ha implementato IMapView<K,V>, codice .NET può usare invece le API di IReadOnlyDictionary<TKey,TValue>. Include tutte le API di Windows Runtime esistenti e anche scenari come l'uso delle API di Windows Runtime componenti originariamente implementati in C++ da un'app C# o Visual Basic.

L'interfaccia IMapView<K,V> rappresenta una raccolta di coppie chiave-valore in cui è possibile accedere a un valore tramite la chiave associata. Proprietà e metodi di IMapView<K,V> supportano funzionalità di tipo dizionario, ad esempio ottenere le dimensioni della raccolta o ricerche, ma non supportano l'aggiunta o la rimozione di elementi perché la mappa è di sola lettura.

Funzioni di estensione C++/WinRT

auto begin() const;

Restituisce un iteratore alla prima coppia chiave-valore della raccolta, per l'uso in algoritmi C++ come cicli basati su for intervalli.

auto end() const;

Restituisce un iteratore a un'ultima coppia chiave-valore della raccolta, per l'uso in algoritmi C++ come cicli basati su for intervallo.

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

Prova a cercare un elemento nella mappa con la chiave. Per i tipi di riferimento, restituisce il valore se trovato o nullptr se non trovato. Per i tipi di valore, restituisce un valore std::facoltativo<V>, che contiene il valore se trovato o non ha alcun valore se non trovato.

Ereditarietà dell'interfaccia

IMapView eredita IIterable usando un vincolo IKeyValuePair . I tipi che implementano IMapView implementano anche i membri dell'interfaccia di IKeyValuePair, con un vincolo di tipo IKeyValuePair . Analogamente, se si usa .NET, è disponibile il supporto per IEnumerable; T>, con il relativo tipo di vincolo come KeyValuePair che usa gli stessi tipi di chiave e valore, come fa l'implementazione di IReadOnlyDictionary<TKey,TValue> .

Proprietà

Metodi

Si applica a

Vedi anche

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