getResourceString (referência da API do cliente)

Retorna a cadeia de caracteres localizada para uma determinada chave associada ao recurso da Web especificado.

Sintaxe

Xrm.Utility.getResourceString(webResourceName,key)

Parâmetros

Valor de retorno

Uma cadeia de caracteres localizada.

Observações

Ao criar recursos da Web RESX, você deve definir explicitamente o valor do idioma e incluir o identificador de localidade (LCID) para o idioma apropriado no nome do recurso da Web. Por exemplo, new_/strings/MyAppResources.1033.resx conteria recursos para a língua inglesa. Consulte Valores de ID de localidade da Microsoft para obter uma lista de valores LCID.

Por exemplo Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") , retornará o valor da cadeia de caracteres localizada para a chave hello de recurso dentro do new_/strings/MyAppResources.1033.resx recurso da Web se o idioma preferido do usuário for o inglês. Observe que a função não se refere a nenhum idioma específico ou nome completo de qualquer recurso da Web RESX. Esta funcionalidade depende do recurso web RESX associado ao recurso web JavaScript chamador como uma dependência. Para obter mais informações: Dependências de recursos da Web.

O valor apropriado da cadeia de caracteres será determinado pela preferência de idioma do usuário individual e pelos idiomas disponíveis na organização. Se não for encontrada uma cadeia de caracteres localizada que corresponda à preferência de idioma do usuário, a cadeia de caracteres localizada retornará automaticamente para o idioma base da organização. Se nenhuma cadeia de caracteres localizada correspondente for encontrada para o idioma base da organização, um valor nulo será retornado. Se nenhum recurso da Web RESX correspondente for encontrado para o LCID do usuário, uma exceção {webResourceName} does not exist. será lançada.

Artigos relacionados

Xrm.Utility
Recursos da Web de cadeia de caracteres (RESX)
Dependências de recursos da Web