ResourceLoader Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Resources

Fornisce l'accesso semplificato alle risorse dell'app, ad esempio le stringhe dell'interfaccia utente dell'app.

API WinUI 2 equivalente per UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (per WinUI nell'SDK per app di Windows, vedere gli spazi dei nomi SDK per app di 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

Ereditarietà

Object Platform::Object IInspectable ResourceLoader

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Usare il metodo ResourceLoader.GetString per ottenere la risorsa stringa identificata da "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");

Commenti

Un oggetto ResourceLoader incapsula una determinata ResourceMap e una ResourceContext combinata in un'API semplice.

È possibile specificare una mappa di risorse specifica quando viene ottenuto ResourceLoader ; se non viene specificata alcuna mappa delle risorse, ResourceLoader fornirà l'accesso al sottoalbero "Resources" della mappa delle risorse principale dell'app.

In generale, le risorse possono essere sensibili alla scalabilità o ad altre caratteristiche di visualizzazione. Per questo motivo, i contesti delle risorse sono in genere associati a una visualizzazione specifica. Poiché un ResourceLoader incapsula un contesto di risorsa, si applica anche a un ResourceLoader. Un ResourceLoader ottenuto usando GetForCurrentView ha un contesto di risorsa associato a una visualizzazione in cui è stato ottenuto. È anche possibile ottenere un ResourceLoader indipendente dalla visualizzazione usando GetForViewIndependentUse

• Ottenere il fattore di scala per la visualizzazione corrente usando la classe DisplayInformation anziché la classe DisplayProperties deprecata.
• Le app che impostano la larghezza esplicita e l'altezza degli elementi devono comunque funzionare correttamente, diversamente dalla visualizzazione di immagini sfocate.
• Ottenere risorse che non sono associate a nessuna visualizzazione ottenendo un ResourceLoader tramite GetForViewIndependentUse.

Vedere Anche dimensioni dello schermo e punti di interruzione.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1903	18362	GetForUIContext

Costruttori

ResourceLoader()	Nota ResourceLoader() può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetForCurrentView(). Costruisce un nuovo oggetto ResourceLoader per il sottoalbero "Resources" dell'app attualmente in esecuzione ResourceMap. API WinUI 2 equivalente per UWP: ResourceLoader() (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
ResourceLoader(String)	Nota ResourceLoader(String) può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetForCurrentView(String). Costruisce un nuovo oggetto ResourceLoader per ResourceMap specificato. API WinUI 2 equivalente per UWP: ResourceLoader(String) (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Metodi

GetDefaultPriPath(String)	Fornisce il percorso del resources.pri file per l'app.
GetForCurrentView()	Ottiene un oggetto ResourceLoader per il sottoalbero Risorse dell'app attualmente in esecuzione ResourceMap. Questo ResourceLoader usa un contesto predefinito associato alla visualizzazione corrente.
GetForCurrentView(String)	Ottiene un oggetto ResourceLoader per ResourceMap specificato. Questo ResourceLoader usa un contesto predefinito associato alla visualizzazione corrente.
GetForUIContext(UIContext)	Ottiene un oggetto ResourceLoader per l'interfaccia utente specificata.
GetForViewIndependentUse()	Ottiene un oggetto ResourceLoader per il sottoalbero Risorse dell'app attualmente in esecuzione ResourceMap. Questo ResourceLoader usa un contesto predefinito non associato a alcuna visualizzazione.
GetForViewIndependentUse(String)	Ottiene un oggetto ResourceLoader per ResourceMap specificato. Questo ResourceLoader usa un contesto predefinito non associato a alcuna visualizzazione.
GetString(String)	Restituisce il valore stringa più appropriato di una risorsa, specificato dall'identificatore di risorsa, per il valore predefinito ResourceContext della visualizzazione in cui è stato ottenuto ResourceLoader.GetForCurrentView. API WinUI 2 equivalente per UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (per WinUI nell'SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
GetStringForReference(Uri)	Nota GetStringForReference può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetStringForUri. Restituisce il valore stringa più appropriato di una risorsa, specificato come URI per un identificatore di risorsa, per il valore ResourceContext predefinito dell'app attualmente in esecuzione.
GetStringForUri(Uri)	Restituisce il valore stringa più appropriato di una risorsa, specificato da un identificatore di risorsa URI (Uniform Resource Identifier), per il valore predefinito ResourceContext dell'app attualmente in esecuzione. API WinUI 2 equivalente per UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (per WinUI nell'SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

Vedi anche

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• Risorse dell'app e Sistema gestione risorse
• Esempio di risorse dell'applicazione e localizzazione