Recursos da Web de cadeia de caracteres (RESX)

Use esses recursos da web para gerenciar strings localizadas em qualquer interface de usuário que você definir ou com mensagens de erro que você exibirá.

Usando recursos da Web do RESX

Os recursos da Web RESX contêm as chaves e os valores de cadeia de caracteres localizados para um único idioma definido usando o formato XML RESX. O RESX é um formato comum para definir recursos localizados para aplicativos do Windows, portanto, há ferramentas comuns disponíveis para trabalhar com esse tipo de arquivo e os fornecedores de localização estarão familiarizados com o trabalho com eles. Quando o arquivo for publicado como um recurso da Web no CRM, ele será convertido em um formato JSON, que será baixado para o aplicativo quando necessário.

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 Valores de ID de Localidade da Microsoft para obter uma lista de valores de LCID.

Para extrair o valor localizado, use a função Xrm.Utility.getResourceString . Esta função aceita dois parâmetros: WebResourceName e keyValue.

Por exemplo, Xrm.Utility.getResourceString("new_/strings/MyAppResources","hello") retornará o valor da cadeia de caracteres localizada para a chave de recurso hello dentro do new_/strings/MyAppResources.1033.resx recurso da Web se o idioma preferencial 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 nenhum 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 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 string localizada correspondente for encontrada para o idioma base da organização, um valor nulo será retornado.

Consulte também

Recursos da Web para o Dynamics 365 Customer Engagement (on-premises)
Crie recursos da Web acessíveis
Criar recursos da Web e conteúdo IFrame para uso com o Dynamics 365 Customer Engagement (on-premises) para clientes móveis
Dependências de recursos da Web
Criar recursos de página (HTML) da Web
Recursos da Web do Silverlight (XAP)
Recursos da Web de script (JScript)
Recursos da web de imagem (JPG, PNG, GIF, ICO)
Recursos da Web de folha de estilo (XSL)
Recursos da Web de dados (XML)
Recursos da web CSS
Mensagens e métodos da entidade WebResource
Exemplo: Passar vários valores para um recurso da Web por meio do parâmetro data
Exemplo: Importar arquivos como recursos da Web
Recursos da Web, ferramentas da comunidade