Internacionalização (i18n) em C# (.NET): guia completo

Internacionalização (i18n) em C# (.NET)

Internacionalização (abreviada como i18n — do inglês "internationalization", onde 18 é o número de letras entre o primeiro "i" e o último "n") — é o processo de projetar software para adaptá-lo a diferentes idiomas, regiões e características culturais sem alterar o código-fonte. Na plataforma .NET (C#), a i18n é implementada por meio de mecanismos de localização e globalização, que são incorporados ao núcleo do framework.

Conceitos principais de i18n no .NET

\n
• Globalização — projetar o aplicativo considerando o suporte a múltiplas culturas (por exemplo, formatação de datas, números, moedas).
\n
• Localização — adaptar a interface para uma cultura específica (tradução de textos, imagens, sons).
\n
• Cultura (Culture) — combinação de idioma e configurações regionais, indicada por um código como ru-RU, en-US, de-DE.
\n
• Arquivos de recurso (.resx) — arquivos XML contendo pares "chave-valor" para cada localidade.
\n

Como funciona a i18n em C# (.NET)

No .NET, a localização usa arquivos de recurso. O arquivo principal (por exemplo, Strings.resx) contém strings no idioma padrão (geralmente inglês). Para cada idioma adicional, é criado um arquivo separado com o sufixo do código de cultura: Strings.ru.resx (russo), Strings.de.resx (alemão). Durante a compilação, esses arquivos são convertidos em assemblies satélite, que são carregados dependendo da cultura atual da thread.

// Exemplo de arquivo de recurso (Strings.resx)\n// Key: HelloMessage, Value: "Hello, World!"\n// Strings.ru.resx\n// Key: HelloMessage, Value: "Привет, мир!"\n

Implementação passo a passo da localização em um aplicativo de console

\n
1. Crie um arquivo de recurso no projeto: clique com o botão direito no projeto → Add → New Item → Resources File. Nomeie-o como Strings.resx.
\n
2. Adicione strings: insira a chave Greeting e o valor Hello, user!.
\n
3. Crie o arquivo para o idioma russo: Strings.ru.resx com a mesma chave e o valor Привет, пользователь!.
\n
4. Escreva o código para definir a cultura e obter a string localizada:
\n

using System.Globalization;\nusing System.Resources;\nusing System.Threading;\n\nclass Program\n{\n    static void Main()\n    {\n        // Define a cultura russa\n        Thread.CurrentThread.CurrentUICulture = new CultureInfo("ru-RU");\n        Thread.CurrentThread.CurrentCulture = new CultureInfo("ru-RU");\n\n        // Obtém o gerenciador de recursos\n        ResourceManager rm = new ResourceManager("YourNamespace.Strings", typeof(Program).Assembly);\n        string greeting = rm.GetString("Greeting");\n\n        Console.WriteLine(greeting); // Exibirá: "Привет, пользователь!"\n    }\n}\n

Localização de aplicativos web ASP.NET Core

No ASP.NET Core, a i18n é implementada por meio de middleware e serviços integrados. Vejamos um exemplo de configuração para MVC ou Razor Pages.

1. Configuração no Program.cs

using Microsoft.AspNetCore.Localization;\nusing System.Globalization;\n\nvar builder = WebApplication.CreateBuilder(args);\n\nbuilder.Services.AddLocalization(options => options.ResourcesPath = "Resources");\nbuilder.Services.AddControllersWithViews()\n    .AddViewLocalization()\n    .AddDataAnnotationsLocalization();\n\nvar app = builder.Build();\n\nvar supportedCultures = new[] { new CultureInfo("en-US"), new CultureInfo("ru-RU") };\napp.UseRequestLocalization(new RequestLocalizationOptions\n{\n    DefaultRequestCulture = new RequestCulture("en-US"),\n    SupportedCultures = supportedCultures,\n    SupportedUICultures = supportedCul