닷넷 세계화 및 지역화

추천 자료: .NET Blazor에 대해 알아보시겠어요? .NET Blazor 알아보기를 확인해보세요!

4/22/2023
25 minutes to read

요약

.NET 8의 글로벌화와 국제화 기능을 이용하여 전 세계 사용자를 대상으로 하는 애플리케이션을 개발할 수 있습니다. 이 글에서는 .NET 8에서의 글로벌화와 국제화의 개념, 그리고 이를 적용하는 방법에 대해 설명합니다.

1. 글로벌화와 국제화의 개념

글로벌화(Globalization)란, 소프트웨어가 다양한 문화권과 언어로 지원되도록 설계 및 개발하는 과정을 말합니다. 이를 통해 사용자들이 소프트웨어를 자신의 언어와 관습에 맞게 사용할 수 있습니다. 국제화(Internationalization)는 글로벌화를 위한 준비 작업으로, 소프트웨어가 다양한 언어와 문화에 쉽게 적용될 수 있도록 기반을 마련하는 것입니다.

2. .NET 8에서의 글로벌화 및 국제화 기능

.NET 8은 다양한 글로벌화 및 국제화 기능을 제공합니다. 주요 기능은 다음과 같습니다.

a. 문자열 리소스: 다양한 언어 및 문화에 대한 문자열 리소스를 생성하고 관리할 수 있습니다. b. 날짜 및 시간 형식: 다양한 문화권의 날짜 및 시간 형식을 지원합니다. c. 숫자 형식: 다양한 문화권의 숫자 형식을 지원합니다. d. 정렬 및 비교: 다양한 언어의 문자열 정렬 및 비교를 지원합니다.

3. 글로벌화 및 국제화 적용 방법

.NET 8에서 글로벌화 및 국제화를 적용하는 방법은 다음과 같습니다.

a. 프로젝트 생성: 새로운 .NET 8 프로젝트를 생성하거나 기존 프로젝트를 업데이트합니다. b. 리소스 파일 생성: 각 지원 언어 및 문화에 대한 리소스 파일을 생성합니다. c. 리소스 관리: 리소스 관리자를 사용하여 리소스 파일을 적절하게 불러오고 사용합니다. d. 날짜, 시간, 숫자 형식 지원: CultureInfo 클래스를 사용하여 날짜, 시간, 숫자 형식을 적절한 형태로 변환합니다. e. 문자열 정렬 및 비교: StringComparison, StringComparer 클래스 등을 이용하여 문자열 정렬 및 비교를 수행합니다.

4. 예제: 간단한 다국어 지원 애플리케이션 만들기

다음 예제에서는 간단한 다국어 지원 애플리케이션을 만들어 .NET 8의 글로벌화 및 국제화 기능을 사용하는 방법을 살펴봅니다.

a. 프로젝트 생성: 새로운 .NET 8 프로젝트를 생성하거나 기존 프로젝트를 업데이트합니다.

b. 리소스 파일 생성: 각 지원 언어 및 문화에 대한 리소스 파일을 생성합니다. 예를 들어, 한국어와 영어를 지원하는 애플리케이션의 경우, 각각 ko-KR와 en-US 리소스 파일을 만듭니다.

c. 리소스 관리: 리소스 관리자를 사용하여 애플리케이션 내에서 리소스 파일을 불러오고 사용합니다. 사용자의 언어와 문화에 맞는 리소스를 자동으로 선택하여 표시합니다.

d. 날짜, 시간, 숫자 형식 지원: CultureInfo 클래스를 사용하여 날짜, 시간, 숫자 형식을 적절한 형태로 변환합니다. 사용자의 문화권에 맞는 날짜, 시간, 숫자 형식을 적용하여 사용자 경험을 개선합니다.

e. 문자열 정렬 및 비교: StringComparison, StringComparer 클래스 등을 이용하여 문자열 정렬 및 비교를 수행합니다. 이를 통해 다양한 언어의 문자열 정렬 및 비교를 정확하게 처리할 수 있습니다.

이러한 단계를 거쳐 .NET 8에서 글로벌화 및 국제화를 적용한 애플리케이션을 개발할 수 있습니다. 이를 통해 전 세계 사용자에게 보다 나은 사용자 경험을 제공할 수 있습니다.

.NET의 System.Globalization 소개

.NET의 System.Globalization은 글로벌화 및 국제화를 지원하기 위한 클래스와 기능을 제공하는 네임스페이스입니다. 이 네임스페이스를 사용하면 다양한 문화권과 언어에 대응하는 애플리케이션을 쉽게 개발할 수 있습니다. System.Globalization 네임스페이스에는 주요 클래스들이 포함되어 있습니다.

주요 클래스

CultureInfo: 문화권에 대한 정보를 제공합니다. 날짜, 시간, 숫자, 통화 등의 형식을 지역화하는 데 사용됩니다. 애플리케이션의 현재 문화권을 설정하거나 사용자가 원하는 문화권을 선택하여 사용할 수 있습니다.
DateTimeFormatInfo: 날짜 및 시간 형식을 지역화하기 위한 정보를 제공합니다. 이 클래스를 사용하여 특정 문화권의 날짜 및 시간 형식을 적용할 수 있습니다.
NumberFormatInfo: 숫자 및 통화 형식을 지역화하기 위한 정보를 제공합니다. 이 클래스를 사용하여 특정 문화권의 숫자 및 통화 형식을 적용할 수 있습니다.
CompareInfo: 문자열 비교를 수행하기 위한 메서드를 제공합니다. 다양한 언어의 문자열 정렬 및 비교를 지원합니다.
RegionInfo: 지역 정보를 제공합니다. 이 클래스를 사용하여 지역별로 다양한 정보(예: 지역 이름, 통화 기호, ISO 국가 코드 등)를 얻을 수 있습니다.

이러한 클래스들을 사용하여 애플리케이션의 글로벌화 및 국제화를 손쉽게 처리할 수 있습니다. System.Globalization 네임스페이스는 다양한 문화권 및 언어를 대응하는 애플리케이션을 개발하는데 필요한 도구를 제공하여 사용자 경험을 향상시키는 데 도움이 됩니다.

.NET에서 CultureInfo 클래스 사용하기

.NET의 CultureInfo 클래스는 애플리케이션에서 문화권에 대한 정보를 제공하고 사용합니다. 이 클래스를 사용하면 날짜, 시간, 숫자, 통화 등의 형식을 지역화할 수 있습니다. 이 아티클에서는 CultureInfo 클래스의 사용 예제를 살펴봅니다.

CultureInfo 클래스의 기본 사용법

CultureInfo 클래스를 사용하여 애플리케이션에서 특정 문화권을 설정하거나 사용자가 원하는 문화권을 선택할 수 있습니다. 다음은 CultureInfo 클래스를 사용하는 간단한 예제입니다.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        // 문화권 설정
        CultureInfo ci = new CultureInfo("ko-KR");

        // 날짜 형식 지역화
        DateTime date = new DateTime(2023, 4, 22);
        Console.WriteLine("날짜 형식: " + date.ToString("D", ci));

        // 숫자 형식 지역화
        double number = 12345.678;
        Console.WriteLine("숫자 형식: " + number.ToString("N", ci));

        // 통화 형식 지역화
        decimal currency = 10000.50M;
        Console.WriteLine("통화 형식: " + currency.ToString("C", ci));
    }
}

이 예제에서는 한국어 문화권(ko-KR)을 설정하고, 날짜, 숫자 및 통화 형식을 해당 문화권에 맞게 지역화합니다.

사용자가 문화권 선택하기

사용자가 원하는 문화권을 선택하여 애플리케이션에 적용할 수도 있습니다.

다음은 여러 나라의 문화권 코드 문자열입니다:

한국: ko-KR
미국: en-US
멕시코: es-MX
중국: zh-CN
일본: ja-JP

다음 예제에서는 사용자에게 문화권을 입력받아 해당 문화권의 날짜 형식을 출력하는 코드입니다.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        Console.Write("문화권 코드를 입력하세요: ");
        string cultureCode = Console.ReadLine();

        try
        {
            CultureInfo ci = new CultureInfo(cultureCode);
            DateTime date = DateTime.Now;
            Console.WriteLine("선택한 문화권의 날짜 형식: " + date.ToString("D", ci));
        }
        catch (Exception ex)
        {
            Console.WriteLine("올바르지 않은 문화권 코드입니다.");
        }
    }
}

이 예제에서는 사용자가 입력한 문화권 코드를 기반으로 CultureInfo 객체를 생성하고, 해당 문화권의 날짜 형식을 출력합니다.

.NET에서 CultureInfo.InvariantCulture 이해하기

.NET의 CultureInfo.InvariantCulture는 문화권에 의존하지 않는 공통의 형식을 사용하여 데이터를 표현할 때 사용하는 특별한 문화권입니다. 이 아티클에서는 CultureInfo.InvariantCulture의 개념과 사용법에 대해 설명합니다.

CultureInfo.InvariantCulture의 개념

CultureInfo.InvariantCulture는 언어나 지역과 관련된 규칙에 영향을 받지 않는 형식을 사용할 때 유용합니다. 이를 사용하면 애플리케이션에서 일관된 형식을 유지하고, 데이터의 손실이나 변형 없이 저장하거나 전송할 수 있습니다.

예를 들어, 숫자를 문자열로 변환할 때 문화권에 따라 소수점 표기가 다릅니다. 이런 경우에 CultureInfo.InvariantCulture를 사용하면 문화권에 독립적인 형식으로 숫자를 표현할 수 있습니다.

CultureInfo.InvariantCulture 사용 예제

다음은 CultureInfo.InvariantCulture를 사용하여 숫자와 날짜를 문화권에 독립적인 형식으로 변환하는 예제입니다.

using System;
using System.Globalization;

class Program
{
    static void Main()
    {
        // 숫자 형식 변환
        double number = 12345.678;
        string numberString = number.ToString(CultureInfo.InvariantCulture);
        Console.WriteLine("문화권에 독립적인 숫자 형식: " + numberString);

        // 날짜 형식 변환
        DateTime date = new DateTime(2023, 4, 22);
        string dateString = date.ToString(CultureInfo.InvariantCulture);
        Console.WriteLine("문화권에 독립적인 날짜 형식: " + dateString);
    }
}

이 예제에서는 숫자와 날짜를 문화권에 독립적인 형식으로 변환하여 출력합니다. 이렇게 하면 애플리케이션에서 일관된 형식을 사용할 수 있으며, 다양한 문화권의 사용자에게도 올바르게 표시됩니다.

CultureInfo.InvariantCulture는 데이터 저장, 파일 입출력, 통신 등에서 일관된 형식을 유지하고자 할 때 유용하게 사용할 수 있습니다.

.NET에서 resx 파일 만들기 및 관리하기

ASP.NET Core MVC에서 resx 파일 만들기 및 관리하기

ASP.NET Core MVC 프로젝트에서 리소스 파일(resx)을 사용하면 여러 언어로 웹사이트를 지원할 수 있습니다. 이 아티클에서는 resx 파일을 만들고 관리하는 방법에 대해 설명합니다.

resx 파일 생성

프로젝트에서 Resources라는 새 폴더를 생성합니다.
Resources 폴더에서 마우스 오른쪽 버튼을 클릭하고, 추가 > 새 항목을 선택하여 새 리소스 파일을 만듭니다. 파일 이름을 지정하고, 파일 확장자를 .resx로 설정합니다 (예: MyResource.resx).

resx 파일에 문자열 리소스 추가

생성한 resx 파일을 열어서, 이름(Name)과 값(Value)을 입력합니다. 이 때 이름은 고유한 문자열이어야 합니다.
다양한 언어를 지원하려면 각 언어에 대한 resx 파일을 추가합니다. 각 파일의 이름은 기본 resx 파일 이름에 문화권 코드를 추가하여 설정합니다 (예: MyResource.ko-KR.resx, MyResource.en-US.resx).

리소스 파일 사용

프로젝트에 ResourceManager 인스턴스를 만듭니다.

using System.Globalization;
using System.Resources;

ResourceManager resourceManager = new ResourceManager("MyNamespace.Resources.MyResource", typeof(Startup).Assembly);

이때, MyNamespace를 프로젝트의 네임스페이스로 변경하고, MyResource를 생성한 resx 파일의 이름으로 변경해야 합니다.

ResourceManager를 사용하여 리소스를 가져옵니다.

string localizedString = resourceManager.GetString("ResourceName", CultureInfo.CurrentCulture);

이때, ResourceName을 resx 파일에 있는 리소스 이름으로 변경해야 합니다.

ControllerBase를 상속받는 컨트롤러에서 리소스 사용

ControllerBase를 상속받는 컨트롤러에서 리소스 매니저를 만들고, 생성자에서 초기화합니다.

public class MyController : ControllerBase
{
    private readonly ResourceManager _resourceManager;

    public MyController()
    {
        _resourceManager = new ResourceManager("MyNamespace.Resources.MyResource", typeof(MyController).Assembly);
    }
}

컨트롤러의 액션에서 리소스 매니저를 사용하여 문자열을 가져옵니다.

public IActionResult Index()
{
    string localizedString = _resourceManager.GetString("ResourceName", CultureInfo.CurrentCulture);
    ViewData["LocalizedString"] = localizedString;
    return View();
}

이제 ASP.NET Core MVC 프로젝트에서 resx 파일을 사용하여 다국어를 지원할 수 있습니다. 이 방법을 사용하면 유지보수가 쉬워지고, 여러 언어로 애플리케이션을 제공할 수 있습니다.

WPF에서 resx 파일 만들기 및 관리하기

WPF 프로젝트에서 리소스 파일(resx)을 사용하면 여러 언어로 애플리케이션을 지원할 수 있습니다. 이 아티클에서는 resx 파일을 만들고 관리하는 방법에 대해 설명합니다.

resx 파일 생성

프로젝트에서 Resources라는 새 폴더를 생성합니다.
Resources 폴더에서 마우스 오른쪽 버튼을 클릭하고, 추가 > 새 항목을 선택하여 새 리소스 파일을 만듭니다. 파일 이름을 지정하고, 파일 확장자를 .resx로 설정합니다 (예: MyResource.resx).

resx 파일에 문자열 리소스 추가

생성한 resx 파일을 열어서, 이름(Name)과 값(Value)을 입력합니다. 이 때 이름은 고유한 문자열이어야 합니다.
다양한 언어를 지원하려면 각 언어에 대한 resx 파일을 추가합니다. 각 파일의 이름은 기본 resx 파일 이름에 문화권 코드를 추가하여 설정합니다 (예: MyResource.ko-KR.resx, MyResource.en-US.resx).

리소스 파일 사용

프로젝트에 ResourceManager 인스턴스를 만듭니다.

using System.Globalization;
using System.Resources;

ResourceManager resourceManager = new ResourceManager("MyNamespace.Resources.MyResource", typeof(MainWindow).Assembly);

이때, MyNamespace를 프로젝트의 네임스페이스로 변경하고, MyResource를 생성한 resx 파일의 이름으로 변경해야 합니다.

ResourceManager를 사용하여 리소스를 가져옵니다.

string localizedString = resourceManager.GetString("ResourceName", CultureInfo.CurrentCulture);

이때, ResourceName을 resx 파일에 있는 리소스 이름으로 변경해야 합니다.

리소스를 XAML에서 사용하기

리소스를 가져와서 프로퍼티에 할당합니다.

public partial class MainWindow : Window
{
    private readonly ResourceManager _resourceManager;

    public MainWindow()
    {
        InitializeComponent();

        _resourceManager = new ResourceManager("MyNamespace.Resources.MyResource", typeof(MainWindow).Assembly);
        LoadResources();
    }

    private void LoadResources()
    {
        string localizedString = _resourceManager.GetString("ResourceName", CultureInfo.CurrentCulture);
        MyTextBlock.Text = localizedString;
    }
}

이제 WPF 프로젝트에서 resx 파일을 사용하여 다국어를 지원할 수 있습니다. 이 방법을 사용하면 유지보수가 쉬워지고, 여러 언어로 애플리케이션을 제공할 수 있습니다.

Blazor Server에서 resx 파일 만들기 및 관리하기

Blazor Server 프로젝트에서 리소스 파일(resx)을 사용하면 여러 언어로 웹 애플리케이션을 지원할 수 있습니다. 이 아티클에서는 resx 파일을 만들고 관리하는 방법에 대해 설명합니다.

resx 파일 생성

프로젝트에서 Resources라는 새 폴더를 생성합니다.
Resources 폴더에서 마우스 오른쪽 버튼을 클릭하고, 추가 > 새 항목을 선택하여 새 리소스 파일을 만듭니다. 파일 이름을 지정하고, 파일 확장자를 .resx로 설정합니다 (예: MyResource.resx).

resx 파일에 문자열 리소스 추가

생성한 resx 파일을 열어서, 이름(Name)과 값(Value)을 입력합니다. 이 때 이름은 고유한 문자열이어야 합니다.
다양한 언어를 지원하려면 각 언어에 대한 resx 파일을 추가합니다. 각 파일의 이름은 기본 resx 파일 이름에 문화권 코드를 추가하여 설정합니다 (예: MyResource.ko-KR.resx, MyResource.en-US.resx).

리소스 파일 사용

프로젝트에 ResourceManager 인스턴스를 만듭니다.

using System.Globalization;
using System.Resources;

ResourceManager resourceManager = new ResourceManager("MyNamespace.Resources.MyResource", typeof(Startup).Assembly);

이때, MyNamespace를 프로젝트의 네임스페이스로 변경하고, MyResource를 생성한 resx 파일의 이름으로 변경해야 합니다.

ResourceManager를 사용하여 리소스를 가져옵니다.

string localizedString = resourceManager.GetString("ResourceName", CultureInfo.CurrentCulture);

이때, ResourceName을 resx 파일에 있는 리소스 이름으로 변경해야 합니다.

리소스를 Razor 컴포넌트에서 사용하기

리소스를 가져와서 프로퍼티에 할당합니다.

@using System.Globalization;
@using System.Resources;
@inject IServiceProvider ServiceProvider

@code {
    private ResourceManager _resourceManager;
    private string _localizedString;

    protected override void OnInitialized()
    {
        _resourceManager = new ResourceManager("MyNamespace.Resources.MyResource", ServiceProvider.GetService(typeof(Startup).Assembly));
        _localizedString = _resourceManager.GetString("ResourceName", CultureInfo.CurrentCulture);
    }
}

Razor 컴포넌트에서 할당된 프로퍼티를 사용합니다.

<p>@_localizedString</p>

이제 Blazor Server 프로젝트에서 resx 파일을 사용하여 다국어를 지원할 수 있습니다. 이 방법을 사용하면 유지보수가 쉬워지고, 여러 언어로 웹 애플리케이션을 제공할 수 있습니다.

IStringLocalizer 사용

1. 프로젝트 준비

먼저, Blazor Server 애플리케이션을 준비합니다. Visual Studio 또는 dotnet CLI를 사용하여 새로운 Blazor Server 프로젝트를 생성할 수 있습니다.

dotnet new blazorserver -o BlazorApp
cd BlazorApp

2. 리소스 파일 추가

다양한 언어를 위한 리소스 파일을 추가합니다. 예를 들어, 영어(en)와 한국어(ko)를 지원하려면 다음과 같이 리소스 파일을 추가할 수 있습니다.

Resources/MyResources.en.resx : 영어 리소스
Resources/MyResources.ko.resx : 한국어 리소스

각 리소스 파일에는 키-값 쌍을 사용하여 번역할 문자열을 정의합니다.

3. 서비스 구성

Startup.cs 파일 또는 .NET 6 이상을 사용하는 경우 Program.cs 파일에서 AddLocalization 메서드를 호출하여 로컬라이제이션 서비스를 구성합니다.

public void ConfigureServices(IServiceCollection services)
{
    services.AddLocalization(options => options.ResourcesPath = "Resources");

    services.AddRazorPages();
    services.AddServerSideBlazor();
}

또한, 애플리케이션의 요청 파이프라인에 로컬라이제이션 미들웨어를 추가합니다.

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRequestLocalization(app.ApplicationServices.GetService<IOptions<RequestLocalizationOptions>>().Value);
    
    // 기타 미들웨어 설정...
}

4. `IStringLocalizer<T>` 사용

특정 페이지 또는 컴포넌트에서 IStringLocalizer<T>를 사용하여 다국어 리소스에 액세스합니다. 예를 들어, Index.razor 페이지에서 사용하는 방법은 다음과 같습니다.

@page "/"
@using Microsoft.Extensions.Localization
@inject IStringLocalizer<MyResources> Localizer

<h1>@Localizer["HelloWorld"]</h1>

여기서 "HelloWorld"는 리소스 파일에 정의된 키입니다.

5. 언어 선택 및 적용

사용자가 원하는 언어를 선택할 수 있도록 언어 선택 기능을 구현합니다. 선택한 언어는 RequestLocalizationOptions를 통해 설정할 수 있습니다.

public void ConfigureServices(IServiceCollection services)
{
    services.Configure<RequestLocalizationOptions>(options =>
    {
        var supportedCultures = new[] { "en-US", "ko-KR" };
        options.SetDefaultCulture(supportedCultures[0])
               .AddSupportedCultures(supportedCultures)
               .AddSupportedUICultures(supportedCultures);
    });

    // 기타 서비스 구성...
}

사용자가 언어를 선택하면 해당 언어를 애플리케이션의 기본 문화권으로 설정하여 내용이 해당 언어로 표시되도록 할 수 있습니다.

6. 테스트 및 배포

개발 중에는 다양한 언어 설정을 테스트하여 모든 번역이 정상적으로 작동하는지 확인합니다. 배포 전에는 모든 리소스 파일이 정확하게 포함되었는지 확인하십시오.

CultureInfo.CreateSpecificCulture를 사용하여 숫자 표현하기

CultureInfo.CreateSpecificCulture()를 사용하면 특정 문화권에 맞게 숫자 구분자를 설정할 수 있습니다. 이를 통해 숫자를 서로 다른 문화권에 따라 다르게 표시할 수 있습니다. 이 아티클에서는 1억을 decimal로 표현하고, 서로 다른 문화권에 따라 숫자 구분자를 설정하는 예제를 작성합니다.

using System;
using System.Globalization;

class Program
{
    static void Main(string[] args)
    {
        decimal number = 100000000.50;

        CultureInfo usCulture = CultureInfo.CreateSpecificCulture("en-US");
        CultureInfo krCulture = CultureInfo.CreateSpecificCulture("ko-KR");
        CultureInfo deCulture = CultureInfo.CreateSpecificCulture("de-DE");

        string formattedNumberInUS = number.ToString("N", usCulture);
        string formattedNumberInKR = number.ToString("N", krCulture);
        string formattedNumberInDE = number.ToString("N", deCulture);

        Console.WriteLine($"미국 문화권에서의 숫자 표현: {formattedNumberInUS}");
        Console.WriteLine($"한국 문화권에서의 숫자 표현: {formattedNumberInKR}");
        Console.WriteLine($"독일 문화권에서의 숫자 표현: {formattedNumberInDE}");
    }
}

.NET에서 날짜와 시간 다루기

닷넷에서 날짜와 시간 다루는 주제는 다음 링크의 아티클을 참고하세요.

.NET에서 날짜와 시간 다루기