Freigeben über


ResourceLoader Klasse

Definition

Bietet vereinfachten Zugriff auf App-Ressourcen wie App-UI-Zeichenfolgen.

Entsprechende WinUI 2-API für UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

public ref class ResourceLoader sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Resources.IResourceLoaderFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class ResourceLoader final
/// [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.Activatable(typeof(Windows.ApplicationModel.Resources.IResourceLoaderFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class ResourceLoader
[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
Vererbung
Object Platform::Object IInspectable ResourceLoader
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Verwenden Sie die ResourceLoader.GetString-Methode , um die durch "Farewell" identifizierte Zeichenfolgenressource abzurufen.

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

Hinweise

Ein ResourceLoader-Objekt kapselt eine bestimmte ResourceMap und einen ResourceContext, die in einer einfachen API kombiniert sind.

Eine bestimmte Ressourcenzuordnung kann angegeben werden, wenn der ResourceLoader abgerufen wird. Wenn keine Ressourcenzuordnung angegeben ist, ermöglicht der ResourceLoader den Zugriff auf die Unterstruktur "Ressourcen" der Standard Ressourcenzuordnung der App.

Im Allgemeinen können Ressourcen empfindlich gegenüber Skalierungs- oder anderen Anzeigemerkmalen sein. Aus diesem Grund werden Ressourcenkontexte in der Regel einer bestimmten Sicht zugeordnet. Da ein ResourceLoader einen Ressourcenkontext kapselt, gilt dies auch für einen ResourceLoader. Ein Mit GetForCurrentViewabgerufener ResourceLoader verfügt über einen Ressourcenkontext, der einer Ansicht zugeordnet ist, in der er abgerufen wurde. Ein ansichtsunabhängiger ResourceLoader kann auch mithilfe von GetForViewIndependentUse abgerufen werden.

  • Rufen Sie den Skalierungsfaktor für die aktuelle Ansicht ab, indem Sie die DisplayInformation-Klasse anstelle der veralteten DisplayProperties-Klasse verwenden.
  • Apps, die die explizite Breite und Höhe von Elementen festlegen, sollten weiterhin funktionieren, außer möglicherweise verschwommene Bilder anzuzeigen.
  • Rufen Sie Ressourcen ab, die keiner Ansicht zugeordnet sind, indem Sie über GetForViewIndependentUse einen ResourceLoader abrufen.

Weitere Informationen finden Sie unter Bildschirmgrößen und Haltepunkte.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1903 18362 GetForUIContext

Konstruktoren

ResourceLoader()

Hinweis

ResourceLoader() kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen GetForCurrentView().

Erstellt ein neues ResourceLoader-Objekt für die Unterstruktur "Resources" der aktuell ausgeführten App Standard ResourceMap.

Entsprechende WinUI 2-API für UWP: ResourceLoader() (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

ResourceLoader(String)

Hinweis

ResourceLoader(String) kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen GetForCurrentView(String).

Erstellt ein neues ResourceLoader-Objekt für die angegebene ResourceMap.

Entsprechende WinUI 2-API für UWP: ResourceLoader(String) (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Methoden

GetDefaultPriPath(String)

Gibt den Speicherort der resources.pri Datei für die App an.

GetForCurrentView()

Ruft ein ResourceLoader-Objekt für die Ressourcen-Unterstruktur der derzeit ausgeführten App Standard ResourceMap ab. Dieser ResourceLoader verwendet einen Standardkontext, der der aktuellen Ansicht zugeordnet ist.

GetForCurrentView(String)

Ruft ein ResourceLoader-Objekt für die angegebene ResourceMap ab. Dieser ResourceLoader verwendet einen Standardkontext, der der aktuellen Ansicht zugeordnet ist.

GetForUIContext(UIContext)

Ruft ein ResourceLoader-Objekt für die angegebene UIContext ab.

GetForViewIndependentUse()

Ruft ein ResourceLoader-Objekt für die Ressourcen-Unterstruktur der derzeit ausgeführten App Standard ResourceMap ab. Dieser ResourceLoader verwendet einen Standardkontext, der keiner Ansicht zugeordnet ist.

GetForViewIndependentUse(String)

Ruft ein ResourceLoader-Objekt für die angegebene ResourceMap ab. Dieser ResourceLoader verwendet einen Standardkontext, der keiner Ansicht zugeordnet ist.

GetString(String)

Gibt den am besten geeigneten Zeichenfolgenwert einer Ressource zurück, der durch den Ressourcenbezeichner angegeben wird, für den Standardmäßigen ResourceContext der Ansicht, in der der ResourceLoader mithilfe von ResourceLoader.GetForCurrentView abgerufen wurde.

Entsprechende WinUI 2-API für UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

GetStringForReference(Uri)

Hinweis

GetStringForReference kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen GetStringForUri.

Gibt den am besten geeigneten Zeichenfolgenwert einer Ressource zurück, der als URI für einen Ressourcenbezeichner für den Standard resourceContext der derzeit ausgeführten App angegeben wird.

GetStringForUri(Uri)

Gibt den am besten geeigneten Zeichenfolgenwert einer Ressource zurück, der durch einen URI-Ressourcenbezeichner (Uniform Resource Identifier) für den Standardressourcentext der derzeit ausgeführten App angegeben wird.

Entsprechende WinUI 2-API für UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Gilt für:

Weitere Informationen