getResourceString (クライアント API 参照)
指定された Web リソースに関連付けられた特定のキーのローカライズされた文字列を返します。
構文
Xrm.Utility.getResourceString(webResourceName,key)
Parameters
件名 | タイプ | Required | Description |
---|---|---|---|
webResourceName |
String | はい | Web リソースの名前。 |
key |
String | はい | ローカライズされた文字列のキー。 |
値を返す
ローカライズされた文字列。
備考
RESX Web リソースを作成するときには、言語値を明示的に設定して、Web リソースの名前に適切な言語のロケール ID (LCID) を含める必要があります。 たとえば、new_/strings/MyAppResources.1033.resx
には英語のリソースが含まれます。 LCID 値のリストについては、Microsoft ロケール ID 値を参照してください。
たとえば、Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello")
は、ユーザーの優先言語が英語である場合には、new_/strings/MyAppResources.1033.resx
Web リソース内でリソース キーのローカライズされた文字列値 hello
を返します。 関数は特定の言語または RESX Web リソースのフル ネームを参照しないことに注意してください。 この機能は、依存関係として呼び出し JavaScript Web リソースに関連付けられている RESX Web リソースに依存します。 詳細情報: Web リソースの依存関係。
適切な文字列値は、各ユーザーの言語設定と組織で使用可能な言語によって決まります。 ローカライズされた文字列がユーザーの言語設定と一致しない場合、ローカライズされた文字列が組織の基本言語に自動的にフォールバックします。 組織の基本言語に一致するローカライズされた文字列が見つからない場合、null 値が返されます。 ユーザーの LCID に一致する RESX Web リソースが見つからない場合、{webResourceName} does not exist.
という例外がスローされます。
関連記事
Xrm.Utility
文字列 (RESX) Web リソース
Web リソースの依存関係
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。