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 LCID (identificador de localidade) para o idioma apropriado no nome do recurso da Web. Por exemplo, new_/strings/MyAppResources.1033.resx conteria recursos para o idioma inglês. Consulte os valores de ID da 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 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. Essa funcionalidade depende do recurso da Web RESX associado a uma ao recurso da Web JavaScript da chamada como uma dependência. Mais informações: dependências de recursos da Web.

O valor de cadeia de caracteres apropriado será determinado pela preferência de idioma do usuário individual e pelos idiomas disponíveis na organização. Se uma cadeia de caracteres localizada não for encontrada que corresponda à preferência de idioma do usuário, a cadeia de caracteres localizada será automaticamente fallback para o idioma base da organização. Se nenhuma string 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á gerada.

Artigos relacionados

Xrm.Utility
Recursos da web de string (RESX)
Dependências de recursos da Web