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>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
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 |
請參閱
工作
參考
system.web 項目 (ASP.NET 設定結構描述)