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

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

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.

Articles associés

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