IMapView<K,V> Interface

Definição

Namespace:

Windows.Foundation.Collections

Representa uma exibição imutável em um mapa.

.NET Essa interface aparece como System.Collections.Generic.IReadOnlyDictionary<TKey, TValue> devido à projeção de linguagem .NET. Em qualquer caso em que um tipo de Windows Runtime tenha implementado IMapView<K,V>, o código .NET pode usar as APIs de IReadOnlyDictionary<TKey, TValue>.

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

Parâmetros de tipo

K

V

Atributos

ContractVersionAttribute GuidAttribute

Implementações

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

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (introduzida na v1.0)

Comentários

Ao programar com o .NET, essa interface fica oculta e os desenvolvedores devem usar a interface TKey do System.Collections.Generic.IReadOnlyDictionary<, TValue> se quiserem implementar um tipo de mapa/dicionário somente leitura. Em qualquer caso em que um tipo de Windows Runtime tenha implementado IMapView<K,V>, o código .NET pode usar as APIs de IReadOnlyDictionary<TKey, TValue>. Isso inclui todas as API de Windows Runtime existentes e também cenários, como o uso das APIs de componentes Windows Runtime originalmente implementados no C++ de um aplicativo C# ou Visual Basic.

A interface K,V> do IMapView<representa uma coleção de pares chave-valor em que um valor pode ser acessado por sua chave associada. Propriedades e métodos da funcionalidade de tipo de dicionário de suporte do IMapView<K,V> , como obter o tamanho da coleção ou pesquisas, mas não dão suporte à adição ou remoção de itens porque o mapa é somente leitura.

Funções de extensão C++/WinRT

Observação

Existem funções de extensão nos tipos de projeção C++/WinRT para determinadas APIs de Windows Runtime. Por exemplo, winrt::Windows::Foundation::IAsyncAction é o tipo de projeção C++/WinRT para IAsyncAction. As funções de extensão não fazem parte da superfície da ABI (interface binária do aplicativo) dos tipos de Windows Runtime reais, portanto, elas não são listadas como membros das APIs de Windows Runtime. Mas você pode chamá-los de dentro de qualquer projeto C++/WinRT. Consulte Funções C++/WinRT que estendem apIs de Windows Runtime.

auto begin() const;

Retorna um iterador para o primeiro par chave-valor da coleção, para uso em algoritmos C++, como loops baseados em for intervalo.

auto end() const;

Retorna um iterador para um após o último par chave-valor da coleção, para uso em algoritmos C++, como loops baseados em for intervalo.

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

Tenta pesquisar um elemento no mapa com a chave. Para tipos de referência, retorna o valor se encontrado ou nullptr , se não for encontrado. Para tipos de valor, retorna um V std::opcional<>, que contém o valor se encontrado ou não tem nenhum valor se não for encontrado.

Herança de interface

IMapView herda IIterable, usando uma restrição IKeyValuePair . Os tipos que implementam o IMapView também implementam os membros da interface de IKeyValuePair, com uma restrição de tipo IKeyValuePair . Da mesma forma, se você estiver usando o .NET, haverá suporte para IEnumerable; T>, com seu tipo de restrição como um KeyValuePair que usa os mesmos tipos de chave e valor, assim como a implementação de TKey,TValue> do IReadOnlyDictionary<.

Propriedades

Size	Obtém o número de elementos no mapa.

Métodos

HasKey(K)	Determina se a exibição do mapa contém a chave especificada.
Lookup(K)	Retorna o item na chave especificada no modo de exibição de mapa.
Split(IMapView<K,V>, IMapView<K,V>)	Divide a exibição do mapa em duas exibições.

Confira também

• IReadOnlyDictionary< TKey,TValue>
• Coleções (C++/CX)