ResourceLoader Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Resources

Proporciona acceso simplificado a los recursos de la aplicación, como las cadenas de interfaz de usuario de la aplicación.

API de WinUI 2 equivalente para UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

public ref class ResourceLoader sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Resources.IResourceLoaderFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ResourceLoader final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.Resources.IResourceLoaderFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ResourceLoader

function ResourceLoader(name)

Public NotInheritable Class ResourceLoader

Herencia

Object Platform::Object IInspectable ResourceLoader

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Use el método ResourceLoader.GetString para obtener el recurso de cadena identificado por "Adiós".

var resourceLoader = Windows.ApplicationModel.Resources.ResourceLoader.GetForCurrentView();
var text = resourceLoader.GetString("Farewell");

auto resourceLoader{ Windows::ApplicationModel::Resources::ResourceLoader::GetForCurrentView() };
winrt::hstring text{ resourceLoader.GetString(L"Farewell") };

auto resourceLoader = Windows::ApplicationModel::Resources::ResourceLoader::GetForCurrentView();
String^ text = resourceLoader->GetString("Farewell");

Comentarios

Un objeto ResourceLoader encapsula un resourceMap determinado y un ResourceContext, combinados en una API simple.

Se puede especificar una asignación de recursos específica cuando se obtiene resourceLoader ; Si no se especifica ninguna asignación de recursos, ResourceLoader proporcionará acceso al subárbol "Recursos" del mapa de recursos principal de la aplicación.

En general, los recursos pueden ser sensibles a la escala u otras características de visualización. Por ese motivo, los contextos de recursos suelen asociarse a una vista específica. Dado que un ResourceLoader encapsula un contexto de recurso, esto también se aplica a un resourceLoader. Un ResourceLoader obtenido mediante GetForCurrentView tiene un contexto de recursos asociado a una vista en la que se obtuvo. También se puede obtener un ResourceLoader independiente de la vista mediante GetForViewIndependentUse.

• Obtenga el factor de escala de la vista actual mediante la clase DisplayInformation en lugar de la clase DisplayProperties en desuso.
• Las aplicaciones que establecen el ancho explícito y el alto de los elementos seguirán funcionando bien, aparte de mostrar imágenes borrosas posiblemente.
• Obtenga recursos que no están asociados a ninguna vista obteniendo un ResourceLoader a través de GetForViewIndependentUse.

Consulte también Tamaños de pantalla y puntos de interrupción.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1903	18362	GetForUIContext

Constructores

ResourceLoader()

Nota: ResourceLoader() se puede modificar o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetForCurrentView(). Construye un nuevo objeto ResourceLoader para el subárbol "Resources" del resourceMap principal de la aplicación que se está ejecutando actualmente. API de WinUI 2 equivalente para UWP: ResourceLoader() (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

ResourceLoader(String)

Nota: ResourceLoader(String) se puede modificar o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetForCurrentView(String). Construye un nuevo objeto ResourceLoader para el objeto ResourceMap especificado. API de WinUI 2 equivalente para UWP: ResourceLoader(String) (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Métodos

GetDefaultPriPath(String)	Proporciona la ubicación del resources.pri archivo para la aplicación.
GetForCurrentView()	Obtiene un objeto ResourceLoader para el subárbol Resources del objeto ResourceMap principal de la aplicación que se está ejecutando actualmente. Este resourceLoader usa un contexto predeterminado asociado a la vista actual.
GetForCurrentView(String)	Obtiene un objeto ResourceLoader para el objeto ResourceMap especificado. Este resourceLoader usa un contexto predeterminado asociado a la vista actual.
GetForUIContext(UIContext)	Obtiene un objeto ResourceLoader para el uiContext especificado.
GetForViewIndependentUse()	Obtiene un objeto ResourceLoader para el subárbol Resources del objeto ResourceMap principal de la aplicación que se está ejecutando actualmente. Este ResourceLoader usa un contexto predeterminado que no está asociado a ninguna vista.
GetForViewIndependentUse(String)	Obtiene un objeto ResourceLoader para el objeto ResourceMap especificado. Este ResourceLoader usa un contexto predeterminado que no está asociado a ninguna vista.
GetString(String)	Devuelve el valor de cadena más adecuado de un recurso, especificado por el identificador de recurso, para el resourceContext predeterminado de la vista en la que se obtuvo ResourceLoader medianteResourceLoader.GetForCurrentView. API de WinUI 2 equivalente para UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).
GetStringForReference(Uri)	Nota: GetStringForReference puede modificarse o no estar disponible para las versiones después de Windows 8.1. En su lugar, use GetStringForUri. Devuelve el valor de cadena más adecuado de un recurso, especificado como URI para un identificador de recurso, para el resourceContext predeterminado de la aplicación que se está ejecutando actualmente.
GetStringForUri(Uri)	Devuelve el valor de cadena más adecuado de un recurso, especificado por un identificador uniforme de recursos (URI), para el resourceContext predeterminado de la aplicación que se está ejecutando actualmente. API de WinUI 2 equivalente para UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

Consulte también

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• Recursos de aplicación y el sistema de administración de recursos
• Ejemplo de recursos de aplicación y localización