ResourceMap Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Resources.Core

Colección de recursos relacionados, normalmente para un paquete de aplicación determinado o un archivo de recursos para un paquete determinado.

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)

Herencia

Object Platform::Object IInspectable ResourceMap

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

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 de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Este ejemplo se basa en el escenario 8 de los recursos de la aplicación y el ejemplo de localización. Consulte el ejemplo para obtener la solución 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;
}

Comentarios

Sintaxis del identificador de recursos

Muchos métodos de esta clase usan identificadores de recursos como parámetros. El identificador de recursos se trata como un fragmento de identificador uniforme de recursos (URI), sujeto a la semántica del identificador uniforme de recursos (URI). Por ejemplo, GetValue("Caption%20") se trata como GetValue("Caption").

No use "?" o "#" en los identificadores de recursos, ya que finalizan la evaluación de la ruta de acceso del recurso. Por ejemplo, "MyResource?3" se trata como "MyResource".

Propiedades

Size	Obtiene el número de recursos del mapa.
Uri	Obtiene un URI que se puede usar para hacer referencia a este objeto ResourceMap.

Métodos

First()	Devuelve un iterador para enumerar los elementos del mapa.
GetSubtree(String)	Devuelve un objeto ResourceMap que representa una parte de otro Objeto ResourceMap, que normalmente se usa para acceder a un archivo de recursos determinado dentro de un paquete de aplicación. Este método busca mapas de subárbol, antecesor, relacionado y primo a este mapa de recursos, así como mapas de nivel superior. Devuelve el mapa de recursos representado por un identificador de mapa de recursos determinado, en relación con este mapa de recursos. Este método se usa normalmente para hacer referencias más sencillas a un subconjunto determinado de recursos, como un único archivo de recursos o un directorio de archivos.
GetValue(String)	Nota GetValue(String) se puede modificar o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetValue(String, ResourceContext). Devuelve el candidato más adecuado para un recurso especificado por un identificador de recurso dentro del contexto predeterminado.
GetValue(String, ResourceContext)	Devuelve el candidato más adecuado para un recurso especificado por un identificador de recurso para el contexto proporcionado.
HasKey(String)	Determina si el mapa puede recuperar un recurso con el identificador de recurso especificado.
Lookup(String)	Devuelve namedResource en el identificador de recurso especificado en el mapa.
Split(IMapView<String,NamedResource>, IMapView<String,NamedResource>)	Divide la vista de mapa en dos vistas.

Consulte también

• Ejemplo de recursos de aplicación y localización