getResourceString (dokumentacja interfejsu API klienta)

Zwraca zlokalizowany ciąg dla danego klucza skojarzonego z określonym zasobem internetowym.

Składnia

Xrm.Utility.getResourceString(webResourceName,key)

Parametry

Wartość zwracana

Zlokalizowany ciąg.

Uwagi

Podczas tworzenia zasobów internetowych RESX należy jawnie ustawić wartość języka i dołączyć identyfikator ustawień regionalnych (LCID) dla odpowiedniego języka w nazwie zasobu internetowego. Na przykład new_/strings/MyAppResources.1033.resx będzie zawierać zasoby dla języka angielskiego. Zobacz Wartości identyfikatorów ustawień regionalnych firmy Microsoft , aby uzyskać listę wartości LCID.

Na przykład Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") zwróci zlokalizowaną wartość ciągu dla klucza hello zasobu w zasobie new_/strings/MyAppResources.1033.resx internetowym, jeśli preferowanym językiem użytkownika jest angielski. Zwróć uwagę, że funkcja nie odnosi się do żadnego określonego języka ani pełnej nazwy żadnego zasobu internetowego RESX. Ta funkcja zależy od tego, czy zasób sieci Web RESX jest skojarzony z wywołującym zasobem sieci Web JavaScript jako zależność. Więcej informacji: Zależności zasobów internetowych.

Odpowiednia wartość ciągu będzie określana przez preferencje językowe poszczególnych użytkowników i języki dostępne w organizacji. Jeśli zlokalizowany ciąg nie zostanie znaleziony, który pasuje do preferencji języka użytkownika, zlokalizowany ciąg automatycznie wróci do języka podstawowego organizacji. Jeśli nie zostanie znaleziony pasujący zlokalizowany ciąg dla języka podstawowego organizacji, zostanie zwrócona wartość null. Jeśli nie zostanie znaleziony pasujący zasób internetowy RESX dla identyfikatora LCID użytkownika, zostanie zgłoszony wyjątek {webResourceName} does not exist. .

Powiązane artykuły

Xrm.Utility
Zasoby sieci Web String (RESX)
Zależności zasobów sieci Web