Udostępnij za pośrednictwem


Globalizacja elementu (ASP.Schemat ustawień netto)

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Konfiguruje ustawienia globalizacji aplikacji.

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.

Atrybuty

Atrybut

Opis

culture

Atrybut opcjonalny.

Określa domyślną kulturę przetwarzania przychodzących żądań sieci Web.

Aby uzyskać prawidłowe ciągi kultur, zobacz System.Globalization.CultureInfo.

Można również ustawić ten atrybut auto.

enableClientBasedCulture

Atrybut opcjonalny.

Ten atrybut nie jest używany w tej chwili.

fileEncoding

Atrybut opcjonalny.

Określa domyślne kodowanie analizy plików .aspx, .asmx i .asax. Pliki Unicode i UTF-8, które są zapisywane wraz z byte order mark prefiks są automatycznie rozpoznawane, niezależnie od wartości dla tego atrybutu.

requestEncoding

Atrybut opcjonalny.

Określa domyślne kodowanie każdego przychodzącego żądania, w tym opublikowanych danych i ciągu kwerendy.

Jeśli żądanie pochodzi z nagłówka żądania, który zawiera Accept-Charset atrybut, zastępuje on ten atrybut w konfiguracji.

Domyślnie jest stosowane kodowanie UTF-8, która jest określona w globalization sekcji w pliku Machine.config, który został utworzony, kiedy.NET Framework został zainstalowany. Jeśli kodowanie żądań nie jest określony w pliku Machine.config lub Web.config, kodowanie domyślne ustawienie regionalne opcje ustawień regionalnych dla komputera.

W aplikacjach jednoserwerowych, ten atrybut i responseEncoding atrybut powinien być taki sam. W przypadkach rzadszych (aplikacje wieloserwerowe, gdzie domyślne kodowania serwerów są różne) może się różnić kodowanie żądań i odpowiedzi za pomocą lokalnych plików Web.config.

responseEncoding

Atrybut opcjonalny.

Określa kodowanie treści odpowiedzi.

Domyślnie jest stosowane kodowanie UTF-8, która jest określona w globalization sekcji w pliku Machine.config, który został utworzony, kiedy.NET Framework został zainstalowany. Jeśli kodowanie odpowiedzi nie jest określony w pliku Machine.config lub Web.config, kodowanie domyślne ustawienie regionalne opcje ustawień regionalnych dla komputera.

W aplikacjach jednoserwerowych, ten atrybuti responseEncoding atrybut powinien być taki sam. W przypadkach rzadszych (aplikacje wieloserwerowe, gdzie domyślne kodowania serwerów są różne) może się różnić kodowanie żądań i odpowiedzi za pomocą lokalnych plików Web.config.

uiCulture

Atrybut opcjonalny.

Określa domyślną kulturę przetwarzania wyszukiwań zasobów zależnych od ustawień regionalnych. Aby uzyskać prawidłowe ciągi kultur, zobacz System.Globalization.CultureInfo.

Można również ustawić ten atrybut auto.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element

Opis

configuration

Określa element główny w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji.

system.web

Określa element główny dla aplikacji ASP.Sekcja konfiguracji netto.

Uwagi

Jeśli serwer lub aplikacja fileEncoding ustawienie atrybutu jest skonfigurowany do używania UTF-16 i UTF-16 jest nie kodowania używanego dla strony .aspx w zakresie pliku konfiguracyjnego, dane wyjściowe, które są wysyłane do przeglądarki klienta zostanie uszkodzona i ewentualnie może wyświetlić kod źródłowy strony. Upewnij się, że skonfigurowany fileEncoding wartość odpowiada kodowania, który jest używany na stronie.

Domyślna konfiguracja

Następujące domyślne globalization element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest domyślnej konfiguracji, który jest zwracany przez aplikację.

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

Przykład

Poniższy przykład kodu demonstruje, jak określić domyślne kodowanie żądań i odpowiedzi dla aplikacji ASP.NET aplikacji.

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

Informacje o elementach

Program obsługi sekcji konfiguracji

System.Web.Configuration.GlobalizationSection

Członkowskie konfiguracji

SystemWebSectionGroup.Globalization

Lokalizacje konfigurowalne

Machine.config

Web.config na poziomie katalogu głównego

Poziom aplikacji Web.config

Directory–level wirtualnego lub fizycznego Web.config

Wymagania

Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0

Microsoft.NET Framework w wersji 1.0, 1.1 lub 2.0

Microsoft Visual Studio 2003 lub Visual Studio 2005

Zobacz też

Zadania

How to: Lock ASP.NET Configuration Settings

Informacje

System.Web elementu (ASP.Schemat ustawień netto)

<configuration> Element

System.Configuration

System.Web.Configuration

Koncepcje

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Inne zasoby

Encoding Base Types

ASP.NET Configuration Files

ASP.NET ustawienia konfiguracji

Ogólne ustawienia konfiguracji (ASP.(NET)

ASP.NET Configuration API