Element globalization (schéma nastavení ASP.NET)

Článek
08/11/2011

Konfiguruje nastavení globalizace pro aplikaci.

<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"/>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
culture	Nepovinný atribut. Určuje výchozí nastavení kultury pro zpracování příchozích webových požadavků. Platné řetězce kultur naleznete v System.Globalization.CultureInfo. Tento atribut lze také nastavit na auto.
enableClientBasedCulture	Nepovinný atribut. Tento atribut není v tuto chvíli používán.
fileEncoding	Nepovinný atribut. Určuje výchozí kódování pro analýzu souborů ASPX, ASMX a ASAX. Soubory Unicode a UTF-8 uložené s prefixem byte order mark jsou automaticky rozpoznány, bez ohledu na hodnotu tohoto atributu.
requestEncoding	Nepovinný atribut. Určuje předpokládané kódování každé příchozí žádosti včetně odeslaných dat a řetězce dotazu. Pokud žádost přichází s hlavičkou požadavku, který obsahuje atribut Accept-Charset, přepíše tento atribut v konfiguraci. Výchozí kódování je UTF-8, které je určeno v oddílu globalization souboru Machine.config, který byl vytvořen při instalaci rozhraní .NET Framework. Pokud není kódování požadavků zadáno v souboru Machine.config nebo Web.config, je výchozí hodnota kódování rovna místnímu nastavení národního prostředí počítače. V aplikacích s jediným serverem by tento atribut a atribut responseEncoding měly být stejné. Pro méně běžný případ (aplikace s více servery, kde jsou výchozí kódování různá), můžete měnit kódování žádosti a odpovědi pomocí místních souborů Web.config.
responseEncoding	Nepovinný atribut. Určuje kódování obsahu odpovědí. Výchozí kódování je UTF-8, které je určeno v oddílu globalization souboru Machine.config, který byl vytvořen při instalaci rozhraní .NET Framework. Pokud není kódování odpovědi zadáno v souboru Machine.config nebo Web.config, je výchozí hodnota kódování rovna místnímu nastavení národního prostředí počítače. V jednom serveru aplikace tento atribut a responseEncoding atributu musí být stejné. Pro méně běžný případ (aplikace s více servery, kde jsou výchozí kódování různá), můžete měnit kódování žádosti a odpovědi pomocí místních souborů Web.config.
uiCulture	Nepovinný atribut. Určuje výchozí nastavení kultury pro zpracování hledání prostředku závislého na nastavení národního prostředí. Platné řetězce kultur naleznete v System.Globalization.CultureInfo. Tento atribut lze také nastavit na auto.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element oddílu konfigurace technologie ASP.NET.

Poznámky

Pokud je nastavení atributu fileEncoding serveru nebo aplikace nakonfigurováno tak, aby použil UTF-16 a UTF-16 není kódování, které se používá pro stránky ASPX v rozsahu konfiguračního souboru, bude výstup, který je odeslán do prohlížeče klienta, poškozen a může případně zobrazit zdrojový kód stránky. Ujistěte se, že nakonfigurovaná hodnota fileEncoding odpovídá kódování, který je používáno stránkou.

Výchozí konfigurace

Následující výchozí element globalization není explicitně nakonfigurován v souboru Machine.config nebo v kořenovém souboru web.config. To je však výchozí konfigurace, kterou vrací aplikace.

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

Příklad

Následující příklad kódu ukazuje, jak určit výchozí kódování požadavků a odpovědí pro aplikace technologie ASP.NET.

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

Informace prvku

Obslužná rutina konfiguračního oddílu	System.Web.Configuration.GlobalizationSection
Konfigurační člen	SystemWebSectionGroup.Globalization
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně Soubor web.config na úrovni fyzického nebo virtuálního adresáře
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 Microsoft .NET Framework verze 1.0, 1.1 nebo 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Element globalization (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály