指定された Web リソースに関連付けられた特定のキーのローカライズされた文字列を返します。
構文
Xrm.Utility.getResourceString(webResourceName,key)
Parameters
| 件名 | タイプ | Required | プロパティ |
|---|---|---|---|
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") は、ユーザーの優先言語が英語である場合には、hello Web リソース内でリソース キーのローカライズされた文字列値 new_/strings/MyAppResources.1033.resx を返します。 関数は特定の言語または RESX Web リソースのフル ネームを参照しないことに注意してください。 この機能は、依存関係として呼び出し JavaScript Web リソースに関連付けられている RESX Web リソースに依存します。 詳細情報: Web リソースの依存関係。
適切な文字列値は、各ユーザーの言語設定と組織で使用可能な言語によって決まります。 ローカライズされた文字列がユーザーの言語設定と一致しない場合、ローカライズされた文字列が組織の基本言語に自動的にフォールバックします。 組織の基本言語に一致するローカライズされた文字列が見つからない場合、null 値が返されます。 ユーザーの LCID に一致する RESX Web リソースが見つからない場合、{webResourceName} does not exist. という例外がスローされます。