자료 참고 안내 1. 본 자료실의 모든 자료 저작권은 ㈜에이치앤에스에 있습니다.

본 자료는 개발하시는데 참고자료 용도로 사용하실 수 있으며 저작권 표시 없이 복사,게재, 출판 하실 수 없습니다. 외부 게재 사용 시 반드시 출처 항목에 회사명과 사이트 주소를 반드시 명시해 주시기 바랍니다.
[표기 예] 출처 : ㈜에이치앤에스(www.hnsts.co.kr) 또는 ㈜HNS(www.hnsts.co.kr)

2. 제품 개발 시 내용과 예제 코드는 수정 및 검증작업을 직접 하셔야 하며 문제 발생에 대한 책임은 ㈜HNS사와 무관합니다.

본사는 자료를 최신내용으로 유지하기 위해 노력하고 있으며 제공되는 정보의 오류 및 내용이 정확하지 않을 경우 사전 공지 없이 업데이트 될 수 있습니다. 자료의 문제점 발견 시 본사로 문의주시면 검토하여 자료를 수정하도록 하겠습니다.

IEC-Series에서 Resource를 사용한 다국어 변경 방법
작성일 2024-08-06 수정일 2024-08-06 조회수 369
분류 Knowhow
적용
플랫폼
키워드 다국어, 지역화, 언어 변경, Font
첨부파일 TechNote82_Example.zip

본 자료는
1. 간편한 다국어 변경에 대한 개요
2. 언어 변경을 위한 Resource 생성
3. 생성한 Resource에서 언어를 가져오기 위한 클래스 사용 방법
4. 예시 코드
순서로 진행합니다.

주의 해당 자료는 다국어 사용을 위한 기본적인 Font 적용 후의 활용 방법에 대한 내용으로 Font 적용에 대한 작업을 진행하지 않으신 경우에는 [Tech Note 59. IEC-Series에서 다국어 출력 방법] 내용을 확인하여 Font를 정상적으로 적용하신 뒤에 아래의 내용을 확인하시기 바랍니다.
1. 간편한 다국어 변경에 대한 개요

여러 개의 국가 언어를 UI에 표시하고자 하는 경우 모든 다국어를 Code로 설정하는 것은 매우 복잡하고 긴 코드 작업이 필요합니다. 복잡하고 긴 코드 작업을 최소화하기 위해서 사용하고자 하는 Text에 대한 국가별 언어를 Resource로 생성하여 필요에 따라서 언어를 한번에 변경할 수 있도록 하기 위한 내용입니다.

아래의 내용들을 확인하여 Resource 생성 방법부터 Code를 통해 Resource에 생성한 언어를 가져오는 방법까지 확인하여 실사용에 적용해보시기 바랍니다.

2. 언어 변경을 위한 Resource 생성

이 자료에서 설명하고자 하는 언어 변경 방법은 다국어를 사용하여 설정될 Text들을 미리 Resource 파일에 저장해두고 필요에 따라서 저장된 Text를 읽어와서 출력하는 방식입니다. 그렇기 때문에 Resource를 생성할 때 사용할 언어별 Resource 파일이 필요합니다. 자세한 Resource 생성 방법은 아래의 STEP을 참고해주시기 바랍니다.

  • [STEP-1] 솔루션 탐색기(Solution Explorer)에서 [Project 우클릭] - [Add] - [New Folder]를 클릭하여 폴더 생성

    복수개의 다국어 Resource를 편리하게 관리하기 위해서 폴더를 생성해줍니다. 해당 설명에서는 예시로 Language라는 이름으로 폴더를 생성하였습니다.

  • [STEP-2] 생성한 폴더에 우클릭 후 [Add] - [New Item] - [Resources File]을 선택하여 Resource 파일을 생성합니다.

    Resource 파일의 경우 이름에 해당 다국어 정보를 입력하는 것이 관리하기에 편리합니다. 해당 설명에서는 예시로 Resource_Ko(한글), Reosurce_EN(영어)로 생성하였습니다.

  • [STEP-3] 생성한 Resource 파일을 열어보면 좌측 상단에 Resource Type이 Strings로 되어 있는지 확인한 뒤 Name과 Value에 사용할 Text와 그에 따른 제목을 작성합니다.

    위 이미지를 보면 "안녕하세요"라는 Text를 사용하는 UI의 경우 Form1에 있는 SmartLabel1이기 때문에 Name을 "Form1_SmartLabe1"로 설정하였고 “감사합니다”라는 Text를 사용하는 UI의 경우 Form2에 있는 SmartLabel2이기 때문에 Name을 "Form2_SmartLabel2"로 설정하였습니다. 이와 같이 예시에서는 어떤 UI에 사용되는 Text인지에 따라서 Name을 설정했지만 자유롭게 Name을 설정해도 괜찮습니다. 다만 Value에 대한 언어별 리소스의 Name값은 반드시 동일해야 합니다. 예를 들어 "안녕하세요"의 영어버전인 "Hello"의 경우 Name 값이 "Form1_SmartLabel1"로 동일한 것을 확인해 보실 수 있습니다.

STEP-1 ~ 3까지의 방법을 통해서 Resource를 생성하는 방법에 대해서 확인해봤습니다. 위 예시에서는 한글과 영어만 사용하는 예시로 두개의 Resource만 만들었지만 사용해야 할 다국어 개수에 맞게 Resource를 생성하여 관리하시기 바랍니다.

3. 생성한 Resource에서 언어를 가져오기 위한 클래스 사용 방법

언어별 Resource 파일 생성이 완료되었다면 생성한 Resource 파일을 사용해서 원하는 국가별 언어를 적용하는 방법에 대해서 설명 드리겠습니다.

// 다국어 사용을 위한 Resource 언어 변환 클래스
public class SmartStringResource
{
private static System.Resources.ResourceManager g_SelectResourceManager;

public static void SelectResource(System.Resources.ResourceManager selResource)
{
// 생성한 언어 Resource에 대한 접근을 위해 선택한 Resource의 ResourceManager를 등록
g_SelectResourceManager = selResource;

}

public static string GetString(string strName)
{
// 선택한 Resource 중 strName으로 설정되어 있는 Name의 Value값을 가져오기
return g_SelectResourceManager.GetString(strName);

}

}

인터페이스명 SelectResource(System.Resources.ResourceManager selResource)
설명 변경할 다국어 Resource를 선택합니다.

[인자]
System.Resources.ResourceManager selResource : 선택한 언어 Resource의 ResourceManager
사용 방법 [예시 코드] // UI의 Text를 영어로 변경하기 위한 Resource 선택
SmartStringResource.SelectResource(Change_Language.Language.Resource_EN.ResourceManager);
// 선택한 Resource의 언어로 변경하기 위한 UI Update
UILanguageChange();
인터페이스명 GetString(string strName)
설명 선택한 다국어 Resource에서 strName과 동일한 Name의 Value값을 가져옵니다.

[인자]
string strName : Resource에서 가져올 Text에 대한 Name값
사용 방법 [예시 코드] private void UILanguageChange()
{
// Resource에 Form1_SmartLabe1이라는 Name을 가지고 있는 Text(Value)를 SmartLabel1의 Text로 설정합니다.
smartLabel1.Text = SmartStringResource.GetString("Form1_smartLabel1");
smartLabel2.Text = SmartStringResource.GetString("Form2_smartLabel2");
}
4. 예시 코드
  • 한글
  • 영어
C# 예제코드
1111
소스코드는 참고 및 학습용으로 버그 및 여러가지 문제가 있을수 있습니다.

public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}

private void Form1_Load(object sender, EventArgs e)
{
// 현재 Form을 MainForm으로 설정합니다.
smartForm1.MainForm = this;
}

private void rad_KO_Click(object sender, EventArgs e)
{
// UI의 Text를 한글로 변경하기 위해 [한글 Resource]를 선택합니다.
SmartStringResource.SelectResource(Change_Language.Language.Resource_Ko.ResourceManager);
// 선택한 Resource를 적용하기 위해 UI 언어 변경을 진행합니다.
UILanguageChange();
}

private void rad_EN_Click(object sender, EventArgs e)
{
// UI의 Text를 영어로 변경하기 위해 [영어 Resource]를 선택합니다.
SmartStringResource.SelectResource(Change_Language.Language.Resource_EN.ResourceManager);
// 선택한 Resource를 적용하기 위해 UI 언어 변경을 진행합니다.
UILanguageChange();
}

// 선택한 Resource에서 UI에 맞는 Text를 가져오기 위한 메소드
private void UILanguageChange()
{
// ※ 화면에서 언어가 변경되었을 때 표시되어야 하는 요소들에 대해서는 모두 아래와 같이 설정을 해주어야 합니다.
// ※ 또한 여러 개의 Form을 사용하는 MDI 구조에서는 언어가 변경되어야 하는 각 Form에서 아래와 같은 설정이 수행되도록 처리가 필요합니다.

// Resource에서 “Form1_XX”라는 Name을 가지고 있는 Value를 가져와 각 UI의 Text로 설정
smartLabel1.Text = SmartStringResource.GetString("Form1_smartLabel1");

smartRadioButton1.Text = SmartStringResource.GetString("Form1_smartRadioButton1");
smartRadioButton2.Text = SmartStringResource.GetString("Form1_smartRadioButton2");
smartRadioButton3.Text = SmartStringResource.GetString("Form1_smartRadioButton3");
smartRadioButton4.Text = SmartStringResource.GetString("Form1_smartRadioButton4");

smartButton1.ButtonText = SmartStringResource.GetString("Form1_smartButton1");

smartCheckBox1.Text = SmartStringResource.GetString("Form1_smartCheckBox1");
smartCheckBox2.Text = SmartStringResource.GetString("Form1_smartCheckBox2");
smartCheckBox3.Text = SmartStringResource.GetString("Form1_smartCheckBox3");
}
}

// 다국어 사용을 위한 Resource 언어 변환 클래스
public class SmartStringResource
{
private static System.Resources.ResourceManager g_SelectResourceManager;

public static void SelectResource(System.Resources.ResourceManager selResource)
{
// 생성한 언어 Resource에 대한 접근을 위해 선택한 Resource의 ResourceManager를 등록
g_SelectResourceManager = selResource;
}

public static string GetString(string strName)
{
// 선택한 Resource 중 strName으로 설정되어 있는 Name의 Value값을 가져오기
return g_SelectResourceManager.GetString(strName);
}
}
VB.NET 예제코드

소스코드는 참고 및 학습용으로 버그 및 여러가지 문제가 있을수 있습니다.

Public Class Form1

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
' 현재 Form을 MainForm으로 설정합니다.
SmartForm1.MainForm = Me
End Sub

Private Sub rad_Ko_Click(ByVal sender As Object, ByVal e As EventArgs) Handles rad_Ko.Click
' UI의 Text를 한글로 변경하기 위해 [한글 Resource]를 선택합니다.
SmartStringResource.SelectResource(My.Resources.Resource_Ko.ResourceManager)
' 선택한 Resource를 적용하기 위해 UI 언어 변경을 진행합니다.
UILanguageChange()
End Sub

Private Sub rad_En_Click(ByVal sender As Object, ByVal e As EventArgs) Handles rad_En.Click
' UI의 Text를 영어로 변경하기 위해 [영어 Resource]를 선택합니다.
SmartStringResource.SelectResource(My.Resources.Resource_EN.ResourceManager)
' 선택한 Resource를 적용하기 위해 UI 언어 변경을 진행합니다.
UILanguageChange()
End Sub

' 선택한 Resource에서 UI에 맞는 Text를 가져오기 위한 메소드
Private Sub UILanguageChange()
' ※ 화면에서 언어가 변경되었을 때 표시되어야 하는 요소들에 대해서는 모두 아래와 같이 설정을 해주어야 합니다.
' ※ 또한 여러 개의 Form을 사용하는 MDI 구조에서는 언어가 변경되어야 하는 각 Form에서 아래와 같은 설정이 수행되도록 처리가 필요합니다.

' Resource에서 “Form1_XX”라는 Name을 가지고 있는 Value를 가져와 각 UI의 Text로 설정
smartLabel1.Text = SmartStringResource.GetString("Form1_smartLabel1")

smartRadioButton1.Text = SmartStringResource.GetString("Form1_smartRadioButton1")
smartRadioButton2.Text = SmartStringResource.GetString("Form1_smartRadioButton2")
smartRadioButton3.Text = SmartStringResource.GetString("Form1_smartRadioButton3")
smartRadioButton4.Text = SmartStringResource.GetString("Form1_smartRadioButton4")

smartButton1.ButtonText = SmartStringResource.GetString("Form1_smartButton1")

smartCheckBox1.Text = SmartStringResource.GetString("Form1_smartCheckBox1")
smartCheckBox2.Text = SmartStringResource.GetString("Form1_smartCheckBox2")
smartCheckBox3.Text = SmartStringResource.GetString("Form1_smartCheckBox3")
End Sub
End Class

' 다국어 사용을 위한 Resource 언어 변환 클래스
Public Class SmartStringResource
Private Shared g_SelectResourceManager As System.Resources.ResourceManager

Public Shared Sub SelectResource(ByVal selResource As System.Resources.ResourceManager)
' 생성한 언어 Resource에 대한 접근을 위해 선택한 Resource의 ResourceManager를 등록
g_SelectResourceManager = selResource
End Sub

Public Shared Function GetString(ByVal strName As String) As String
' 선택한 Resource 중 strName으로 설정되어 있는 Name의 Value값을 가져오기
Return g_SelectResourceManager.GetString(strName)
End Function
End Class
맨 위로
팝업닫기

(주)에이치앤에스('http://hnsts.co.kr/'이하 '(주)에이치앤에스 웹사이트')는 개인정보보호법에 따라 이용자의 개인정보 보호 및 권익을 보호하고 개인정보와 관련한 이용자의 고충을 원활하게 처리할 수 있도록 다음과 같은 처리방침을 두고 있습니다.

(주)에이치앤에스 웹사이트는 개인정보처리방침을 개정하는 경우 웹사이트 공지사항(또는 개별공지)을 통하여 공지할 것입니다.

○ 본 방침은 2011년 4월 1일부터 시행됩니다.

1. 개인정보의 처리 목적 (주)에이치앤에스 웹사이트는 개인정보를 다음의 목적을 위해 처리합니다. 처리한 개인정보는 다음의 목적 이외의 용도로는
사용되지 않으며 이용 목적이 변경될 시에는 사전동의를 구할 예정 입니다.
가. 민원사무 처리
민원인의 신원 확인, 민원사항 확인, 사실조사를 위한 연락 · 통지, 처리결과 통보 등을 목적으로 개인정보를 처리합니다.
2. 개인정보 파일 현황
1. 개인정보 파일명 : 고객의 소리
  • - 개인정보 항목 : 이메일, 휴대전화번호, 자택전화번호, 이름, 서비스 이용 기록, 접속 로그, 쿠키, 접속 IP 정보
  • - 수집방법 : 웹사이트
  • - 보유근거 : 이용자 동의
  • - 보유기간 : 3년
3. 개인정보의 제3자 제공에 관한 사항
① (주)에이치앤에스 웹사이트는 원칙적으로 이용자의 개인정보를 제1조에서 명시한 목적 범위 내에서 처리하며, 본래의 범위를 초과하여 처리하거나 제3자에게 제공하지 않습니다.
다만, 다음의 경우에는 개인정보를 제3자에게 제공할 수 있습니다.
  • – 이용자가 사전에 제3자 제공 및 공개에 동의한 경우
  • – 법령 등에 의해 제공이 요구되는 경우
  • – 서비스의 제공에 관한 계약의 이행을 위하여 필요한 개인정보로서 경제적/기술적인 사유로 통상의 동의를 받는 것이 현저히 곤란한 경우
  • – 개인을 식별하기에 특정할 수 없는 상태로 가공하여 이용하는 경우
4. 정보주체의 권리,의무 및 그 행사방법 이용자는 개인정보주체로서 다음과 같은 권리를 행사할 수 있습니다.
① 정보주체는 (주)에이치앤에스 웹사이트에 대해 언제든지 다음 각 호의 개인정보 보호 관련 권리를 행사할 수 있습니다.
  • 1. 개인정보 열람요구
  • 2. 오류 등이 있을 경우 정정 요구
  • 3. 삭제요구
  • 4. 처리정지 요구
② 제1항에 따른 권리 행사는 (주)에이치앤에스 웹사이트에 대해 개인정보 보호법 시행규칙 별지 제8호 서식에 따라 서면, 전자우편, 모사전송(FAX) 등을 통하여 하실 수 있으며 (주)에이치앤에스 웹사이트는
이에 대해 지체 없이 조치하겠습니다.
③ 정보주체가 개인정보의 오류 등에 대한 정정 또는 삭제를 요구한 경우에는 (주)에이치앤에스 웹사이트는 정정 또는 삭제를 완료할 때까지 당해 개인정보를 이용하거나 제공하지 않습니다.
④ 제1항에 따른 권리 행사는 정보주체의 법정대리인이나 위임을 받은 자 등 대리인을 통하여 하실 수 있습니다. 이 경우 개인정보 보호법 시행규칙 별지 제11호 서식에 따른 위임장을
제출하셔야 합니다.
5. 제3자에게의 개인정보 제공
① (주)에이치앤에스 웹사이트는 다음의 개인정보 항목을 처리하고 있습니다.
<민원사무 처리>
– 필수항목 : 이름, 휴대전화번호, 자택전화번호, 이메일, 서비스 이용 기록, 접속로그, 쿠키, 접속IP 정보
6. 개인정보의 파기
(주)에이치앤에스 웹사이트는 원칙적으로 개인정보 처리목적이 달성된 경우에는 지체없이 해당 개인정보를 파기합니다. 파기의 절차, 기한 및 방법은 다음과 같습니다.
  • –파기절차 이용자가 입력한 정보는 목적 달성 후 별도의 DB에 옮겨져(종이의 경우 별도의 서류) 내부 방침 및 기타 관련 법령에 따라 일정기간 저장된 후 혹은 즉시 파기됩니다. 이 때, DB로 옮겨진 개인정보는 법률에 의한 경우가 아니고서는 다른 목적으로 이용되지 않습니다.-파기기한이용자의 개인정보는 개인정보의 보유기간이 경과된 경우에는 보유기간의 종료일로부터 5일 이내에, 개인정보의 처리 목적 달성, 해당 서비스의 폐지, 사업의 종료 등 그 개인정보가 불필요하게 되었을 때에는 개인정보의 처리가 불필요한 것으로 인정되는 날로부터 5일 이내에 그 개인정보를 파기합니다.
  • –파기방법 전자적 파일 형태의 정보는 기록을 재생할 수 없는 기술적 방법을 사용합니다. 종이에 출력된 개인정보는 분쇄기로 분쇄하거나 소각을 통하여 파기합니다.
7. 개인정보의 안전성 확보 조치
(주)에이치앤에스 웹사이트는 개인정보보호법 제29조에 따라 다음과 같이 안전성 확보에 필요한 기술적/관리적 및 물리적 조치를 하고 있습니다.
1. 정기적인 자체 감사 실시
개인정보 취급 관련 안정성 확보를 위해 정기적(분기 1회)으로 자체 감사를 실시하고 있습니다.
2. 개인정보 취급 직원의 최소화 및 교육
개인정보를 취급하는 직원을 지정하고 담당자에 한정시켜 최소화 하여 개인정보를 관리하는 대책을 시행하고 있습니다.
3. 내부관리계획의 수립 및 시행
개인정보의 안전한 처리를 위하여 내부관리계획을 수립하고 시행하고 있습니다.
4. 해킹 등에 대비한 기술적 대책
(주)에이치앤에스 웹사이트는 해킹이나 컴퓨터 바이러스 등에 의한 개인정보 유출 및 훼손을 막기 위하여 보안프로그램을 설치하고 주기적인 갱신·점검을 하며 외부로부터 접근이 통제된 구역에
시스템을 설치하고 기술적/물리적으로 감시 및 차단하고 있습니다.
5. 개인정보의 암호화
이용자의 개인정보는 비밀번호는 암호화 되어 저장 및 관리되고 있어, 본인만이 알 수 있으며 중요한 데이터는 파일 및 전송 데이터를 암호화 하거나 파일 잠금 기능을 사용하는 등의
별도 보안기능을 사용하고 있습니다.
6. 접속기록의 보관 및 위변조 방지
개인정보처리시스템에 접속한 기록을 최소 6개월 이상 보관, 관리하고 있으며, 접속 기록이 위변조 및 도난, 분실되지 않도록 보안기능 사용하고 있습니다.
7. 개인정보에 대한 접근 제한
개인정보를 처리하는 데이터베이스시스템에 대한 접근권한의 부여,변경,말소를 통하여 개인정보에 대한 접근통제를 위하여 필요한 조치를 하고 있으며 침입차단시스템을 이용하여
외부로부터의 무단 접근을 통제하고 있습니다.
8. 문서보안을 위한 잠금장치 사용
개인정보가 포함된 서류, 보조저장매체 등을 잠금장치가 있는 안전한 장소에 보관하고 있습니다.
9. 비인가자에 대한 출입 통제
개인정보를 보관하고 있는 물리적 보관 장소를 별도로 두고 이에 대해 출입통제 절차를 수립, 운영하고 있습니다.
8. 개인정보 보호책임자 작성
① (주)에이치앤에스 웹사이트는 개인정보 처리에 관한 업무를 총괄해서 책임지고, 개인정보 처리와 관련한 정보주체의 불만처리 및 피해구제 등을 위하여 아래와 같이 개인정보 보호책임자를
지정하고 있습니다.
▶ 개인정보 보호책임자
성명 : 김진효
소속 : (주)에이치앤에스
전화번호 : 02-6402-8001
이메일 : hns@hnsts.co.kr
② 정보주체께서는 (주)에이치앤에스 웹사이트의 서비스(또는 사업)을 이용하시면서 발생한 모든 개인정보 보호 관련 문의, 불만처리, 피해구제 등에 관한 사항을 개인정보 보호책임자 및
담당부서로 문의하실 수 있습니다. (주)에이치앤에스 웹사이트는 정보주체의 문의에 대해 지체 없이 답변 및 처리해드릴 것입니다.
9. 개인정보침해 구제방법
정보주체는 개인정보침해로부터 구제받고자 하는 경우 다음과 같은 기관에 도움을 요청할 수 있습니다.
▶ 개인정보 침해신고센터 (한국인터넷진흥원 운영)
– 소관업무 : 개인정보 침해사실 신고, 상담 신청
– 홈페이지 : privacy.kisa.or.kr
– 전화 : (국번없이) 118
– 주소 : (138-950) 서울시 송파구 중대로 135 한국인터넷진흥원 개인정보침해신고센터
▶ 개인정보 분쟁조정위원회 (한국인터넷진흥원 운영)
– 홈페이지 : privacy.kisa.or.kr
– 전화 : (국번없이) 118
– 주소 : (138-950) 서울시 송파구 중대로 135 한국인터넷진흥원 개인정보침해신고센터
10. 개인정보 처리방침 변경
① 이 개인정보처리방침은 시행일로부터 적용되며, 법령 및 방침에 따른 변경내용의 추가, 삭제 및 정정이 있는 경우에는 변경사항의 시행 7일 전부터 공지사항을 통하여 고지할
것입니다.
팝업닫기

본 웹사이트에 게시된 이메일 주소가 전자우편 수집 프로그램이나 그 밖의 기술적 장치를 이용하여 무단으로 수집되는 것을 거부하며, 이를 위반시 정보통신망법에 의해 형사처벌됨을 유념하시기 바랍니다.

게시일 : 2011.4.1