ResourceMap Classe

Definição

Namespace:

Windows.ApplicationModel.Resources.Core

Uma coleção de recursos relacionados, normalmente para um pacote de aplicativo específico ou um arquivo de recurso para um pacote específico.

public ref class ResourceMap sealed : IIterable<IKeyValuePair<Platform::String ^, NamedResource ^> ^>, IMapView<Platform::String ^, NamedResource ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ResourceMap final : IIterable<IKeyValuePair<winrt::hstring, NamedResource const&>>, IMapView<winrt::hstring, NamedResource const&>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ResourceMap : IEnumerable<KeyValuePair<string,NamedResource>>, IReadOnlyDictionary<string,NamedResource>

Public NotInheritable Class ResourceMap
Implements IEnumerable(Of KeyValuePair(Of String, NamedResource)), IReadOnlyDictionary(Of String, NamedResource)

Herança

Object Platform::Object IInspectable ResourceMap

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,NamedResource>> IIterable<IKeyValuePair<Platform::String,NamedResource>> IIterable<IKeyValuePair<winrt::hstring,NamedResource>> IReadOnlyDictionary<String,NamedResource> IMapView<Platform::String,NamedResource> IMapView<winrt::hstring,NamedResource>

Requisitos do Windows

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

Exemplos

Este exemplo se baseia no cenário 8 do exemplo de localização e recursos de aplicativo. Consulte o exemplo para obter a solução completa.

private void ShowText()
{
    ResourceContext defaultContextForCurrentView = ResourceContext.GetForCurrentView();
    ResourceMap stringResourcesResourceMap = ResourceManager.Current.MainResourceMap.GetSubtree("Resources");
    Scenario8MessageTextBlock.Text = stringResourcesResourceMap.GetValue("string1", defaultContextForCurrentView).ValueAsString;
}

void Scenario8::ShowText()
{
    ResourceContext^ defaultContextForCurrentView = ResourceContext::GetForCurrentView();
    auto resourceStringMap = ResourceManager::Current->MainResourceMap->GetSubtree("Resources");
    Scenario8MessageTextBlock->Text = resourceStringMap->GetValue("string1", defaultContextForCurrentView)->ValueAsString;
}

Comentários

Sintaxe do identificador de recurso

Muitos métodos dessa classe usam identificadores de recurso como parâmetros. O identificador de recurso é tratado como um fragmento de URI (Uniform Resource Identifier), sujeito à semântica do URI (Uniform Resource Identifier). Por exemplo, GetValue("Caption%20") é tratado como GetValue("Caption ").

Não use "?" ou "#" nos identificadores de recurso, pois eles encerram a avaliação do caminho de recurso. Por exemplo, "MyResource?3" é tratado como "MyResource".

Propriedades

Size	Obtém o número de recursos no mapa.
Uri	Obtém um URI que pode ser usado para se referir a este ResourceMap.

Métodos

First()	Retorna um iterador para enumerar os itens no mapa.
GetSubtree(String)	Retorna um ResourceMap que representa uma parte de outro ResourceMap, normalmente usado para acessar um arquivo de recurso específico dentro de um pacote de aplicativos. Esse método localiza mapas de subárvore, ancestral, irmão e primo para esse mapa de recursos, bem como mapas de nível superior. Ele retorna o mapa de recursos representado por um determinado identificador de mapa de recursos, em relação a esse mapa de recursos. Esse método normalmente é usado para fazer referências mais simples a um subconjunto específico de recursos, como um único arquivo de recurso ou um diretório de arquivos.
GetValue(String)	Observação GetValue(String) pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetValue(String, ResourceContext). Retorna o candidato mais apropriado para um recurso especificado por um identificador de recurso dentro do contexto padrão.
GetValue(String, ResourceContext)	Retorna o candidato mais apropriado para um recurso especificado por um identificador de recurso para o contexto fornecido.
HasKey(String)	Determina se o mapa pode recuperar um recurso com o identificador de recurso especificado.
Lookup(String)	Retorna o NamedResource no identificador de recurso especificado no mapa.
Split(IMapView<String,NamedResource>, IMapView<String,NamedResource>)	Divide a exibição do mapa em dois modos de exibição.

Confira também

• Amostra de recursos e localização de aplicativos