globalization 項目 (ASP.NET 設定結構描述)

設定應用程式的全球化設定。

<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

選擇性屬性。

指定處理外來 Web 要求的預設文化特性。

如需有效的文化特性字串,請參閱 System.Globalization.CultureInfo

這個屬性也可以設定為 auto

enableClientBasedCulture

選擇性屬性。

這個屬性目前並未使用。

fileEncoding

選擇性屬性。

指定 .aspx、.asmx 和 .asax 檔案剖析的預設編碼方式。不論這個屬性的值為何,會自動地辨識以 byte order mark 前置字元儲存的 Unicode 和 UTF-8 檔案。

requestEncoding

選擇性屬性。

指定每個外來要求的假設編碼方式,包括張貼的資料和查詢字串。

如果要求具有包含 Accept-Charset 屬性的要求標頭,就會覆寫組態中的這個屬性。

預設編碼方式為 UTF-8,這個值在 .NET Framework 安裝時所建立之 Machine.config 檔的 globalization 區段中指定。若未在 Machine.config 或 Web.config 檔案中指定要求編碼方式,則預設編碼方式為電腦的 [區域選項] 地區設定。

在單一伺服器的應用程式中,這個屬性和 responseEncoding 屬性應該是相同的。在較不普遍的情況中 (預設伺服器編碼方式不同的多重伺服器應用程式),您可以使用本機的 Web.config 檔案變更要求和回應的編碼方式。

responseEncoding

選擇性屬性。

指定回應的內容編碼方式。

預設編碼方式為 UTF-8,這個值在 .NET Framework 安裝時所建立之 Machine.config 檔的 globalization 區段中指定。若未在 Machine.config 或 Web.config 檔案中指定回應編碼方式,則預設編碼方式為電腦的 [區域選項] 地區設定。

在單一伺服器的應用程式中,這個屬性和 responseEncoding 屬性應該是相同的。在較不普遍的情況中 (預設伺服器編碼方式不同的多重伺服器應用程式),您可以使用本機的 Web.config 檔案變更要求和回應的編碼方式。

uiCulture

選擇性屬性。

指定處理地區設定相關資源搜尋的預設文化特性。如需有效的文化特性字串,請參閱 System.Globalization.CultureInfo

這個屬性也可以設定為 auto

子項目

無。

父項目

項目 描述

configuration

指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。

system.web

指定 ASP.NET 組態區段的根項目。

備註

如果伺服器或應用程式的 fileEncoding 屬性是設定為使用 UTF-16,而在組態檔的範圍 (Scope) 中 .aspx 網頁不是使用 UTF-16 做為編碼方式,則傳送至用戶端瀏覽器的輸出將會損毀,且可能顯示網頁的原始程式碼。請確定設定的 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

組態成員

System.Web.Configuration.SystemWebSectionGroup.Globalization

可設定的位置

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

虛擬或實體目錄層級的 Web.config

需求

Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版

Microsoft .NET Framework 1.0、1.1 或 2.0 版

Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

工作

HOW TO:鎖定 ASP.NET 組態設定

參考

system.web 項目 (ASP.NET 設定結構描述)
<configuration> 項目
System.Configuration
System.Web.Configuration

概念

將基底型別編碼
ASP.NET 組態概觀
ASP.NET Web 伺服器控制項和瀏覽器能力
保護 ASP.NET 組態
ASP.NET 組態案例

其他資源

ASP.NET 組態檔
ASP.NET 組態設定
一般組態設定 (ASP.NET)
ASP.NET 組態 API