Condividi tramite


getResourceString (informazioni di riferimento sulle API client)

Restituisce la stringa localizzata per una determinata chiave associata alla risorsa Web specificata.

Sintassi

Xrm.Utility.getResourceString(webResourceName,key)

Parametri

Nome TIPO Obbligatorio Description
webResourceName String Yes Nome della risorsa Web.
key String Yes Chiave per la stringa localizzata.

Valore restituito

Stringa localizzata.

Osservazioni:

Quando si creano risorse Web RESX, è necessario impostare in modo esplicito il valore della lingua e includere l'identificatore delle impostazioni locali (LCID) per la lingua appropriata nel nome della risorsa Web. Ad esempio, new_/strings/MyAppResources.1033.resx conterrebbe risorse per la lingua inglese. Per un elenco di valori LCID, vedere Valori ID impostazioni locali Microsoft .

Ad esempio Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") , restituirà il valore della stringa localizzata per la chiave hello di risorsa all'interno della new_/strings/MyAppResources.1033.resx risorsa Web se la lingua preferita dell'utente è inglese. Si noti che la funzione non fa riferimento a un linguaggio specifico o a un nome completo di qualsiasi risorsa Web RESX. Questa funzionalità dipende dal fatto che la risorsa Web RESX sia associata alla risorsa Web JavaScript chiamante come dipendenza. Altre informazioni: Dipendenze delle risorse Web.

Il valore stringa appropriato verrà determinato dalla preferenza di lingua dell'utente singolo e dalle lingue disponibili nell'organizzazione. Se non viene trovata una stringa localizzata che corrisponde alla preferenza di lingua dell'utente, la stringa localizzata eseguirà automaticamente il fallback alla lingua di base per l'organizzazione. Se non viene trovata alcuna stringa localizzata corrispondente per la lingua di base dell'organizzazione, verrà restituito un valore nullo. Se non viene trovata alcuna risorsa Web RESX corrispondente per LCID dell'utente, verrà generata un'eccezione {webResourceName} does not exist. .

Xrm.Utility
Risorse web stringa (RESX)
Dipendenze delle risorse Web