Freigeben über

getResourceString (Client-API-Referenz)

  • Artikel

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.

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