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

發行項
08/12/2011

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

<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
組態成員	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

請參閱

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

屬性和項目

屬性

子項目

父項目

備註

預設的組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源