Práticas recomendadas para o desenvolvimento de aplicativos preparados para globalização

  • Artigo

Essa seção descreve as práticas recomendadas a serem seguidas no desenvolvimento de aplicativos prontos para o mundo.

Práticas recomendadas de globalização

  1. Crie o aplicativo Unicode internamente.

  2. Use as classes com reconhecimento de cultura fornecidas pelo namespace System.Globalization para manipular e formatar dados.

    • Para classificar, use a classe SortKey e a classe CompareInfo.
    • Para comparações de cadeia de caracteres, use a classe CompareInfo.
    • Para formatação de data e hora, use a classe DateTimeFormatInfo.
    • Para formatação numérica, use a classe NumberFormatInfo.
    • Para calendários gregoriano e não gregorianos, use a classe Calendar ou uma das implementações de calendário específicas.

  3. Em determinadas situações, use as configurações das propriedades de cultura fornecidas pela classe System.Globalization.CultureInfo. Use a propriedade CultureInfo.CurrentCulture para formatar tarefas, como a data e a hora, ou a formatação numérica. Use a propriedade CultureInfo.CurrentUICulture para recuperar recursos. Observe que as propriedades CurrentCulture e CurrentUICulture podem ser definidas por threads.

  4. Habilite seu aplicativo para ler e gravar dados em várias codificações usando as classes de codificação no namespace System.Text. Não aceite dados ASCII. Suponha que caracteres internacionais sejam fornecidos em todos os lugares que um usuário possa inserir texto. Por exemplo, o aplicativo deve aceitar caracteres internacionais em nomes de servidor, diretórios, nomes de arquivos, nomes de usuário e URLs.

  5. Ao usar a classe UTF8Encoding, por motivos de segurança, use o recurso de detecção de erros oferecido pela classe. Para ativar o recurso de detecção de erro, crie uma instância da classe usando o construtor que usa um parâmetro throwOnInvalidBytes e defina o valor desse parâmetro como true.

  6. Sempre que possível, trate as cadeias de caracteres como cadeias de caracteres inteiras em vez de tratá-las como uma série de caracteres individuais. Isso é especialmente importante durante a classificação ou a pesquisa de subcadeias de caracteres. Isso evitará problemas associados à análise de caracteres combinados. Você também pode trabalhar com unidades de texto em vez de com caracteres únicos usando a classe System.Globalization.StringInfo.

  7. Exiba o texto usando as classes fornecidas pelo namespace System.Drawing.

  8. Para ser consistente entre sistemas operacionais, não permita que as configurações de usuário substituam CultureInfo. Use o constructo CultureInfo que aceita um parâmetro useUserOverride e define-o como false.

  9. Teste a funcionalidade de seu aplicativo em versões de sistemas operacionais internacionais usando dados internacionais.

  10. Se uma decisão de segurança for baseada no resultado de uma comparação de cadeia de caracteres ou de uma operação de alteração entre maiúsculas e minúsculas, use uma operação de cadeia de caracteres sem detecção de cultura. Essa prática garante que o resultado não seja afetado pelo valor de CultureInfo.CurrentCulture. Confira a seção "Comparações de cadeia de caracteres que usam a cultura atual" das Práticas recomendadas para usar cadeias de caracteres para obter um exemplo que demonstra como as comparações de cadeias de caracteres com detecção de cultura podem produzir resultados inconsistentes.

Práticas recomendadas de localização

  1. Mova todos os recursos localizáveis para separar DLLs somente de recursos. Os recursos localizáveis incluem elementos da interface do usuário, como cadeias de caracteres, mensagens de erro, caixas de diálogo, menus e recursos do objeto inserido.

  2. Não codifique cadeias de caracteres ou recursos da interface do usuário.

  3. Não coloque recursos não localizáveis em DLLs somente de recursos. Isso confunde os tradutores.

  4. Não use cadeias de caracteres compostas compiladas em tempo de execução de frases concatenadas. As cadeias de caracteres compostas são difíceis de localizar já que elas muitas vezes assumem uma ordem gramatical em inglês que não se aplica a todos os idiomas.

  5. Evite constructos ambíguos, como "Empty Folder" (Pasta vazia), em que as cadeias de caracteres podem ser traduzidas de forma diferente dependendo das funções gramaticais dos componentes da cadeia de caracteres. Por exemplo, "empty", em inglês, pode ser um verbo ou um adjetivo (esvaziar/vazio) e isso pode levar a diferentes traduções em idiomas como italiano ou francês.

  6. No aplicativo, evite usar imagens e ícones que contenham texto. Fica caro localizá-los.

  7. Dê espaço suficiente ao comprimento das cadeias de caracteres para que elas possam se expandir na interface do usuário. Em alguns idiomas, as frases podem exigir de 50 a 75% mais espaço do que em outros idiomas.

  8. Use a classe System.Resources.ResourceManager para recuperar os recursos com base na cultura.

  9. Use o Visual Studio para criar caixas de diálogo do Windows Forms para que elas possam ser localizadas usando o Editor de Recursos do Windows Forms (Winres.exe). Não codifique manualmente as caixas de diálogo do Windows Forms.

  10. Procure um profissional de localização (tradução).

  11. Para obter uma descrição completa sobre a criação e a localização de recursos, confira Recursos em aplicativos do .NET.

Práticas recomendadas de globalização para aplicativos ASP.NET

Dica

As melhores práticas a seguir são para aplicativos ASP.NET Framework. Para aplicativos ASP.NET Core, confira Globalização e localização em ASP.NET Core.

  1. Defina explicitamente as propriedades CurrentUICulture e CurrentCulture em seu aplicativo. Não confie em padrões.

  2. Observe que os aplicativos ASP.NET são aplicativos gerenciados e, portanto, podem usar as mesmas classes como outros aplicativos gerenciados para recuperar, exibir e manipular informações com base na cultura.

  3. Lembre-se de que você pode especificar os seguintes três tipos de codificações no ASP.NET:

    • requestEncoding especifica a codificação recebida do navegador do cliente.
    • responseEncoding especifica a codificação a ser enviada ao navegador do cliente. Na maioria das situações, essa codificação deve ser a mesma codificação especificada para requestEncoding.
    • fileEncoding especifica a codificação padrão da análise de arquivos .aspx, .asmx e .asax.

  4. Especifique os valores dos atributos requestEncoding, responseEncoding, fileEncoding, culture e uiCulture nos seguintes três locais em um aplicativo ASP.NET:

    • Na seção de globalização de um arquivo Web.config. Este arquivo é externo no aplicativo ASP.NET. Para saber mais, confira Elemento <globalization>.
    • Em uma diretiva de página. Observe que, quando um aplicativo está em uma página, isso significa que o arquivo já foi lido. Portanto, já não é possível especificar fileEncoding e requestEncoding. Somente uiCulture, culture e responseEncoding podem ser especificados em uma diretiva de página.
    • No código do aplicativo de forma programática. Essa configuração pode variar se houver uma solicitação. Com uma diretiva de página, quando o código do aplicativo for atingido, já terá passado da hora de especificar fileEncoding e requestEncoding. Somente uiCulture, culture e responseEncoding podem ser especificados no código do aplicativo.

  5. Observe que o valor de uiCulture pode ser definido para o navegador do idioma aceito.

Confira também