globalization-Element (ASP.NET-Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Konfiguriert die Globalisierungseinstellungen für eine Anwendung.
<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 sowie untergeordnete und ü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 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. |
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. Es ist jedoch 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 |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer 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
Aufgaben
How to: Lock ASP.NET Configuration Settings
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
Konzepte
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Weitere Ressourcen
ASP.NET-Konfigurationseinstellungen