getResourceString (Client-API-Referenz)

Gibt die lokalisierte Zeichenfolge für einen gegebenen Schlüssel zurück, der einer bestimmten Webressource zugeordnet ist.

Syntax

Xrm.Utility.getResourceString(webResourceName,key)

Parameter

Name des Dataflows	Type	Erforderlich	Beschreibung
webResourceName	String	Ja	Der Name der Webressource.
key	String	Ja	Der Schlüssel für die lokalisierte Zeichenfolge.

Zurückgegebener Wert

Eine lokalisierte Zeichenfolge.

Anmerkungen

Wenn Sie RESX-Webressourcen erstellen, müssen Sie den Sprachenwert explizit festlegen sowie den Gebietsschemabezeichner (LCID) für die entsprechende Sprache im Namen der Webressource einschließen. Beispielsweise new_/strings/MyAppResources.1033.resx würde Ressourcen für englische Sprache enthalten. Siehe Microsoft lokale ID-Werte für eine Liste von LCID-Werten.

Beispielsweise gibt Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") den lokalisierten Zeichenfolgenwert für den Ressourcenschlüssel hello innerhalb der new_/strings/MyAppResources.1033.resx-Webressource zurück, wenn die bevorzugte Sprache des Benutzers Englisch ist. Beachten Sie, dass die Funktion sich nicht auf eine bestimmte Sprache oder vollständigen Namen der RESX-Webressource bezieht. Die Funktionalität ist von der RESX-Webressource abhängig, die mit der aufrufenden JavaScript-Webressource als Abhängigkeit verknüpft ist. Weitere Informationen: Webressourcenabhängigkeiten.

Der entsprechende Zeichenfolgenwert wird festgelegt durch die Spracheinstellung des einzelnen Benutzers und die Sprachen, die in der Organisation verfügbar sind. Wenn eine isolierte Zeichenfolge nicht gefunden wird, die der Spracheinstellung des Benutzers entspricht, wird automatisch die lokalisierte Zeichenfolge auf die Ausgangssprache für die Organisation zurückgesetzt. Wenn keine entsprechende Zeichenfolge für die Organisationsausgangssprache gefunden wird, wird ein NULL-Wert zurückgegeben. Wenn keine übereinstimmende RESX-Webressource für die LCID des Benutzers gefunden wird, wird eine Ausnahme {webResourceName} does not exist. geworfen.

Ähnliche Artikel

Xrm.Utility
Zeichenfolge (RESX) Webressourcen
Abhängigkeiten von Webressourcen

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).