ResourceLoader Classe

Définition

Espace de noms:

Windows.ApplicationModel.Resources

Fournit un accès simplifié aux ressources d’application telles que les chaînes d’interface utilisateur d’application.

API WinUI 2 équivalente pour UWP : Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application 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

Héritage

Object Platform::Object IInspectable ResourceLoader

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Utilisez la méthode ResourceLoader.GetString pour obtenir la ressource de chaîne identifiée par « 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");

Remarques

Un objet ResourceLoader encapsule un ResourceMap particulier et un ResourceContext, combinés dans une API simple.

Une carte de ressources spécifique peut être spécifiée lors de l’obtention du ResourceLoader ; si aucune carte de ressources n’est spécifiée, ResourceLoader fournit l’accès à la sous-arborescence « Ressources » de la carte de ressources main de l’application.

En général, les ressources peuvent être sensibles à la mise à l’échelle ou à d’autres caractéristiques d’affichage. Pour cette raison, les contextes de ressources sont généralement associés à une vue spécifique. Étant donné qu’un ResourceLoader encapsule un contexte de ressource, cela s’applique également à un ResourceLoader. Un ResourceLoader obtenu à l’aide de GetForCurrentView a un contexte de ressource associé à une vue dans laquelle il a été obtenu. Un ResourceLoader indépendant de l’affichage peut également être obtenu à l’aide de GetForViewIndependentUse

• Obtenez le facteur de mise à l’échelle de la vue actuelle à l’aide de la classe DisplayInformation au lieu de la classe DisplayProperties dépréciée.
• Les applications qui définissent explicitement la largeur et la hauteur des éléments doivent toujours fonctionner correctement, sauf éventuellement l’affichage d’images floues.
• Obtenez des ressources qui ne sont associées à aucune vue en obtenant un ResourceLoader via GetForViewIndependentUse.

Consultez également Tailles d’écran et points d’arrêt.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1903	18362	GetForUIContext

Constructeurs

ResourceLoader()

Notes ResourceLoader() peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetForCurrentView(). Construit un nouvel objet ResourceLoader pour la sous-arborescence « Resources » du main ResourceMap de l’application en cours d’exécution. API WinUI 2 équivalente pour UWP : ResourceLoader() (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

ResourceLoader(String)

Notes ResourceLoader(String) peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetForCurrentView(String). Construit un nouvel objet ResourceLoader pour le ResourceMap spécifié. API WinUI 2 équivalente pour UWP : ResourceLoader(String) (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Méthodes

GetDefaultPriPath(String)	Fournit l’emplacement du resources.pri fichier pour l’application.
GetForCurrentView()	Obtient un objet ResourceLoader pour la sous-arborescence Resources du main ResourceMap de l’application en cours d’exécution. Ce ResourceLoader utilise un contexte par défaut associé à l’affichage actuel.
GetForCurrentView(String)	Obtient un objet ResourceLoader pour le ResourceMap spécifié. Ce ResourceLoader utilise un contexte par défaut associé à l’affichage actuel.
GetForUIContext(UIContext)	Obtient un objet ResourceLoader pour l’UIContext spécifié.
GetForViewIndependentUse()	Obtient un objet ResourceLoader pour la sous-arborescence Resources du main ResourceMap de l’application en cours d’exécution. Ce ResourceLoader utilise un contexte par défaut qui n’est associé à aucune vue.
GetForViewIndependentUse(String)	Obtient un objet ResourceLoader pour le ResourceMap spécifié. Ce ResourceLoader utilise un contexte par défaut qui n’est associé à aucune vue.
GetString(String)	Retourne la valeur de chaîne la plus appropriée d’une ressource, spécifiée par l’identificateur de ressource, pour le ResourceContext par défaut de la vue dans laquelle le ResourceLoader a été obtenu à l’aide de ResourceLoader.GetForCurrentView. API WinUI 2 équivalente pour UWP : Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).
GetStringForReference(Uri)	Notes GetStringForReference peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt GetStringForUri. Retourne la valeur de chaîne la plus appropriée d’une ressource, spécifiée en tant qu’URI pour un identificateur de ressource, pour le ResourceContext par défaut de l’application en cours d’exécution.
GetStringForUri(Uri)	Retourne la valeur de chaîne la plus appropriée d’une ressource, spécifiée par un identificateur de ressource URI (Uniform Resource Identifier), pour le ResourceContext par défaut de l’application en cours d’exécution. API WinUI 2 équivalente pour UWP : Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Voir aussi

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• Ressources d’application et système de gestion des ressources
• Exemple de ressources d’application et de localisation