ResourceMap Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Atributos
- 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. |