globalization 요소(ASP.NET 설정 스키마)

아티클
05/27/2012

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

응용 프로그램의 전역화 설정을 구성합니다.

<globalization
    enableClientBasedCulture="true|false"
    requestEncoding="any valid encoding string"
    responseEncoding="any valid encoding string"
    fileEncoding="any valid encoding string"

    responseHeaderEncoding = "any valid encoding string" 
    resourceProviderFactoryType = string
    enableBestFitResponseEncoding = "true|false"

    culture="any valid culture string"
    uiCulture="any valid culture string"/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
culture	선택적 특성입니다. 들어오는 웹 요청을 처리하기 위한 기본 culture를 지정합니다. 올바른 culture 문자열을 보려면 System.Globalization.CultureInfo를 참조하십시오. 이 특성을 auto로 설정할 수도 있습니다.
enableClientBasedCulture	선택적 특성입니다. 이 특성은 현재 사용되고 있지 않습니다.
fileEncoding	선택적 특성입니다. .aspx, .asmx 및 .asax 파일 구문 분석에 대한 기본 인코딩을 지정합니다. byte order mark 접두사를 사용하여 저장한 유니코드 및 UTF-8 파일은 이 특성의 값에 관계없이 자동으로 인식됩니다.
requestEncoding	선택적 특성입니다. 게시된 데이터와 쿼리 문자열을 포함하여 들어오는 각 요청이 암호화되었다고 지정합니다. 요청이 Accept-Charset 특성을 포함하는 요청 헤더와 함께 전달되면 구성에서 이 특성이 재정의됩니다. 기본 인코딩은 .NET Framework를 설치할 때 만들어진 Machine.config 파일의 globalization 섹션에 지정된 UTF-8입니다. Machine.config 또는 Web.config 파일에 요청 인코딩이 지정되어 있지 않으면 인코딩은 기본값으로 컴퓨터의 국가별 옵션 로캘 설정으로 지정됩니다. 단일 서버 응용 프로그램에서는 이 특성과 responseEncoding 특성이 같아야 합니다. 일반적이지는 않지만 기본 서버 인코딩이 각각 다른 다중 서버 응용 프로그램의 경우에는 로컬 Web.config 파일을 사용하여 요청 및 응답 인코딩을 다르게 지정할 수 있습니다.
responseEncoding	선택적 특성입니다. 응답의 내용 인코딩을 지정합니다. 기본 인코딩은 .NET Framework를 설치할 때 만들어진 Machine.config 파일의 globalization 섹션에 지정된 UTF-8입니다. Machine.config 또는 Web.config 파일에 응답 인코딩이 지정되어 있지 않으면 인코딩은 기본값으로 컴퓨터의 국가별 옵션 로캘 설정으로 지정됩니다. 단일 서버 응용 프로그램에서는 이 특성과 responseEncoding 특성이 같아야 합니다. 일반적이지는 않지만 기본 서버 인코딩이 각각 다른 다중 서버 응용 프로그램의 경우에는 로컬 Web.config 파일을 사용하여 요청 및 응답 인코딩을 다르게 지정할 수 있습니다.
uiCulture	선택적 특성입니다. 로캘 종속 리소스 검색을 처리하기 위한 기본 culture를 지정합니다. 올바른 culture 문자열을 보려면 System.Globalization.CultureInfo를 참조하십시오. 이 특성을 auto로 설정할 수도 있습니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소를 지정합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.

설명

서버 또는 응용 프로그램의 fileEncoding 특성 설정이 UTF-16을 사용하도록 구성되어 있고 UTF-16이 구성 파일의 범위에서 .aspx 페이지에 사용되는 인코딩이 아니면 클라이언트 브라우저로 보내는 출력이 손상되고 페이지의 소스 코드가 표시될 수도 있습니다. 구성된 fileEncoding 값이 페이지에 사용되는 인코딩과 일치하는지 확인하십시오.

기본 구성

다음의 기본 globalization 요소는 Machine.config 파일 또는 루트 Web.config 파일에 명시적으로 구성되어 있지 않습니다. 그러나 이 요소는 응용 프로그램에서 반환하는 기본 구성입니다.

<globalization requestEncoding="utf-8" 
               responseEncoding="utf-8" 
               fileEncoding="" 
               culture="" 
               uiCulture="" 
               enableClientBasedCulture="false" 
               responseHeaderEncoding="utf-8" 
               resourceProviderFactoryType="" 
               enableBestFitResponseEncoding="false" />

예제

다음 코드 예제에서는 ASP.NET 응용 프로그램의 기본 요청 및 응답 인코딩을 지정하는 방법을 보여 줍니다.

<configuration>
   <system.web>
      <globalization 
         requestEncoding="iso-8859-1"
         responseEncoding="iso-8859-1"/>
   </system.web>
</configuration>

요소 정보

구성 섹션 처리기	System.Web.Configuration.GlobalizationSection
구성 멤버	SystemWebSectionGroup.Globalization
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 Microsoft .NET Framework 버전 1.0, 1.1 또는 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005

참고 항목