globalization-Element (ASP.NET-Einstellungsschema)

Artikel
09/03/2008

Aktualisiert: November 2007

Konfiguriert die Globalisierungseinstellungen für eine Anwendung.

<configuration>-Element
system.web-Element (ASP.NET-Einstellungsschema)
globalization-Element (ASP.NET-Einstellungsschema)

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
culture	Optionales Attribut Gibt die Standardkultur für die Verarbeitung eingehender Webanforderungen an. Informationen zu gültigen Kulturzeichenfolgen finden Sie unter System.Globalization.CultureInfo. Dieses Attribut kann auch auf auto festgelegt werden.
enableClientBasedCulture	Optionales Attribut Dieses Attribut wird zur Zeit nicht verwendet.
fileEncoding	Optionales Attribut Gibt die Standardcodierung für die Analyse von ASPX-, ASMX- und ASAX-Dateien an. Unicode-Dateien und UTF-8-Dateien, die mit dem byte order mark-Präfix gespeichert werden, werden unabhängig vom Wert dieses Attributs automatisch erkannt.
requestEncoding	Optionales Attribut. Gibt die angenommene Codierung aller eingehenden Anforderungen an, einschließlich gesendeter Daten und der Abfragezeichenfolge. Wenn die eingehende Anforderung einen Anforderungsheader mit einem Accept-Charset-Attribut enthält, überschreibt die Anforderung dieses Attribut in der Konfiguration. Die Standardcodierung ist UTF-8. Dies wird im globalization-Abschnitt der Datei Machine.config angegeben, die bei der Installation von .NET Framework erstellt wurde. Wenn die Anforderungscodierung in der Datei Machine.config bzw. Web.config nicht angegeben ist, gelten für die Codierung die Ländereinstellungen des Computers. In Einzelserveranwendungen sollten dieses Attribut und das responseEncoding-Attribut gleich sein. In speziellen Fällen (wenn Anwendungen auf mehreren Servern mit verschiedenen Standardservercodierungen ausgeführt werden) können Sie die Codierung von Anforderungen und Antworten mithilfe der lokalen Dateien Web.config variieren.
responseEncoding	Optionales Attribut Gibt die Inhaltscodierung von Antworten an. Die Standardcodierung ist UTF-8. Dies wird im globalization-Abschnitt der Datei Machine.config angegeben, die bei der Installation von .NET Framework erstellt wurde. Wenn die Antwortcodierung nicht in der Datei Machine.config bzw. Web.config angegeben ist, gelten für die Codierung die Ländereinstellungen des Computers. In Einzelserveranwendungen sollten dieses Attributund das responseEncoding-Attribut gleich sein. In speziellen Fällen (wenn Anwendungen auf mehreren Servern mit verschiedenen Standardservercodierungen ausgeführt werden) können Sie die Codierung von Anforderungen und Antworten mithilfe der lokalen Dateien Web.config variieren.
uiCulture	Optionales Attribut Gibt die Standardkultur für die Verarbeitung von Ressourcensuchvorgängen an, die von den Ländereinstellungen abhängen. Informationen zu gültigen Kulturzeichenfolgen finden Sie unter System.Globalization.CultureInfo. Dieses Attribut kann auch auf auto festgelegt werden.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Gibt das Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Hinweise

Wenn das fileEncoding-Attribut des Servers oder der Anwendung für die Verwendung von UTF-16 konfiguriert ist und UTF-16 nicht die Codierung ist, die für eine ASPX-Seite im Gültigkeitsbereich der Konfigurationsdatei verwendet wird, wird die an den Clientbrowser gesendete Ausgabe beschädigt, und möglicherweise wird der Quellcode der Seite angezeigt. Stellen Sie sicher, dass der konfigurierte fileEncoding-Wert zur Codierung passt, die in der Seite verwendet wird.

Standardkonfiguration

Das folgende globalization-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert. Aber es ist die Standardkonfiguration, die von der Anwendung zurückgegeben wird.

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die Standardcodierung der Anforderungen und Antworten für eine ASP.NET-Anwendung angegeben wird.

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

Elementinformationen

Konfigurationsabschnittshandler	System.Web.Configuration.GlobalizationSection
Konfigurationsmember	SystemWebSectionGroup.Globalization
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 Microsoft .NET Framework, Version 1.0, 1.1 oder 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Freigeben über

globalization-Element (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Konzepte

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen