Partager via

getResourceString (référence de l’API client)

  • Article

Renvoie la chaîne localisée pour une clé donnée associée à la ressource Web spécifiée.

Syntaxe

Xrm.Utility.getResourceString(webResourceName,key)

Paramètres

Nom Type Requise Description
webResourceName String Oui Nom de la ressource Web.
key String Oui Clé de la chaîne localisée.

Valeur renvoyée

Chaîne localisée.

Remarques

Lorsque vous créez des ressources Web RESX, vous devez explicitement définir la valeur de la langue et inclure l’identificateur de langue (LCID) adapté dans le nom de la ressource Web. Par exemple, new_/strings/MyAppResources.1033.resx contient des ressources pour l’anglais. Voir Valeurs d’ID de paramètres régionaux Microsoft pour une liste de valeurs LCID.

Par exemple, Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") renvoie la valeur de chaîne localisée pour la clé de ressource hello dans la ressource Web new_/strings/MyAppResources.1033.resx si la langue par défaut de l’utilisateur est l’anglais. Notez que la fonction ne référencie aucune langue spécifique ou nom complet d’aucune ressource web RESX. Cette fonctionnalité dépend de la ressource Web RESX associée à la ressource Web appelante en JavaScript en tant que dépendance. Pour plus d’informations, voir Dépendances des ressources Web.

La valeur de chaîne appropriée sera déterminée par la politique de la langue de l’utilisateur individuel et les langues disponibles dans l’organisation. S’il n’est pas possible de trouver une chaîne qui correspond à la politique de la langue de l’utilisateur, la chaîne revient automatiquement dans la langue de base de l’organisation. Si aucune chaîne localisée correspondante n’est détectée pour la langue de base des organisations, une valeur nulle sera retournée. Si le LCID du client ne trouve aucune ressource Web RESX correspondante, une exception {webResourceName} does not exist. est levée.

Xrm.Utility
Ressources web de chaîne (RESX)
Dépendances des ressources Web

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).