ResourceLoader Classe

Definição

Namespace:

Windows.ApplicationModel.Resources

Fornece acesso simplificado aos recursos do aplicativo, como cadeias de caracteres de interface do usuário do aplicativo.

API equivalente do WinUI 2 para UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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

Herança

Object Platform::Object IInspectable ResourceLoader

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Use o método ResourceLoader.GetString para obter o recurso de cadeia de caracteres identificado por "Farewell".

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

Comentários

Um objeto ResourceLoader encapsula um ResourceMap específico e um ResourceContext, combinados em uma API simples.

Um mapa de recursos específico pode ser especificado quando o ResourceLoader é obtido; se nenhum mapa de recursos for especificado, o ResourceLoader fornecerá acesso à subárvore "Recursos" do mapa de recursos main do aplicativo.

Em geral, os recursos podem ser sensíveis à escala ou a outras características de exibição. Por esse motivo, os contextos de recursos geralmente são associados a uma exibição específica. Como um ResourceLoader encapsula um contexto de recurso, isso também se aplica a um ResourceLoader. Um ResourceLoader obtido usando GetForCurrentView tem um contexto de recurso associado a uma exibição na qual ele foi obtido. Um ResourceLoader independente de exibição também pode ser obtido usando GetForViewIndependentUse

• Obtenha o fator de escala para a exibição atual usando a classe DisplayInformation em vez da classe DisplayProperties preterida .
• Os aplicativos que definem a largura explícita e a altura dos elementos ainda devem funcionar bem, além de possivelmente exibir imagens desfocadas.
• Obtenha recursos que não estão associados a nenhuma exibição obtendo um ResourceLoader por meio de GetForViewIndependentUse.

Consulte também Tamanhos de tela e pontos de interrupção.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1903	18362	GetForUIContext

Construtores

ResourceLoader()

Observação ResourceLoader() pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetForCurrentView(). Constrói um novo objeto ResourceLoader para a subárvore "Resources" do main ResourceMap do aplicativo em execução no momento. API equivalente do WinUI 2 para UWP: ResourceLoader() (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

ResourceLoader(String)

Observação ResourceLoader(String) pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetForCurrentView(String). Constrói um novo objeto ResourceLoader para o ResourceMap especificado. API equivalente do WinUI 2 para UWP: ResourceLoader(String) (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Métodos

GetDefaultPriPath(String)	Fornece o local do resources.pri arquivo para o aplicativo.
GetForCurrentView()	Obtém um objeto ResourceLoader para a subárvore Resources do ResourceMap main do aplicativo em execução no momento. Esse ResourceLoader usa um contexto padrão associado à exibição atual.
GetForCurrentView(String)	Obtém um objeto ResourceLoader para o ResourceMap especificado. Esse ResourceLoader usa um contexto padrão associado à exibição atual.
GetForUIContext(UIContext)	Obtém um objeto ResourceLoader para o UIContext especificado.
GetForViewIndependentUse()	Obtém um objeto ResourceLoader para a subárvore Resources do ResourceMap main do aplicativo em execução no momento. Este ResourceLoader usa um contexto padrão que não está associado a nenhuma exibição.
GetForViewIndependentUse(String)	Obtém um objeto ResourceLoader para o ResourceMap especificado. Este ResourceLoader usa um contexto padrão que não está associado a nenhuma exibição.
GetString(String)	Retorna o valor de cadeia de caracteres mais apropriado de um recurso, especificado pelo identificador de recurso, para o ResourceContext padrão da exibição na qual o ResourceLoader foi obtido usando ResourceLoader.GetForCurrentView. API equivalente do WinUI 2 para UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).
GetStringForReference(Uri)	Observação GetStringForReference pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use GetStringForUri. Retorna o valor de cadeia de caracteres mais apropriado de um recurso, especificado como um Uri para um identificador de recurso, para o ResourceContext padrão do aplicativo em execução no momento.
GetStringForUri(Uri)	Retorna o valor de cadeia de caracteres mais apropriado de um recurso, especificado por um identificador de recurso URI (Uniform Resource Identifier), para o ResourceContext padrão do aplicativo em execução no momento. API equivalente do WinUI 2 para UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo Windows).

Confira também

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• Os recursos de aplicativo e o Sistema de Gerenciamento de Recursos
• Amostra de recursos e localização de aplicativos