Partager via


ResourceLoader Classe

Définition

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.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
Héritage
Object Platform::Object IInspectable ResourceLoader
Attributs

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).

S’applique à

Voir aussi