globalization Ögesi (ASP.NET Ayarlar Şeması)

Bir uygulama için genelleştirme ayarları yapılandırır.

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

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst ögeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Öznitelik

Açıklama

culture

İsteğe bağlı öznitelik.

Gelen Web isteklerini işlemek için kullanılan varsayılan kültür değerini belirtir.

Geçerli kültür dizeleri için, bkz. System.Globalization.CultureInfo.

Bu öznitelik auto olarak da ayarlanabilir.

enableClientBasedCulture

İsteğe bağlı öznitelik.

Bu öznitelik şu anda kullanımda değildir.

fileEncoding

İsteğe bağlı öznitelik.

.aspx, .asmx ve .asax dosya ayrıştırma işlemleri için kullanılan varsayılan kodlamayı belirtir. byte order mark önekiyle kaydedilen Unicode ve UTF-8 dosyaları, bu özniteliğin değeri ne olursa olsun otomatik olarak tanınır.

requestEncoding

İsteğe bağlı öznitelik.

Gelen her istekte bulunması beklenen, gönderilen veriler ve sorgu dizesi gibi kodlama değerlerini belirtir.

Accept-Charset özniteliği içeren bir istek üstbilgisi isteği gelirse, yapılandırmadaki bu özniteliği geçersiz kılar.

Varsayılan kodlama, .NET Framework yüklendiğinde oluşturulan Machine.config dosyasındaki globalization bölümünde belirtilen UTF-8'dir. Machine.config veya Web.config dosyasında istek kodlaması belirtilmezse, kodlamada bilgisayar için Bölge Seçenekleri yerel ayarı kullanılır.

Tek sunuculu uygulamalarda bu öznitelik ve responseEncoding özniteliği aynı olmalıdır. Daha az karşılaşılan durumda (varsayılan sunucu kodlamaları farklı olan birden çok sunuculu uygulamalar), yerel Web.config dosyalarını kullanarak istek ve yanıt kodlamasını değiştirebilirsiniz.

responseEncoding

İsteğe bağlı öznitelik.

Yanıtların içerik kodlamasını belirtir.

Varsayılan kodlama, .NET Framework yüklendiğinde oluşturulan Machine.config dosyasındaki globalization bölümünde belirtilen UTF-8'dir. Machine.config veya Web.config dosyasında yanıt kodlaması belirtilmezse, kodlamada bilgisayar için Bölge Seçenekleri yerel ayarı kullanılır.

Tek sunuculu uygulamalarda, bu öznitelik ve responseEncoding özniteliği aynı olması gerekir. Daha az karşılaşılan durumda (varsayılan sunucu kodlamaları farklı olan birden çok sunuculu uygulamalar), yerel Web.config dosyalarını kullanarak istek ve yanıt kodlamasını değiştirebilirsiniz.

uiCulture

İsteğe bağlı öznitelik.

Yerel ayara bağımlı kaynak aramalarını işlemek için kullanılan varsayılan kültür değerini belirtir. Geçerli kültür dizeleri için, bkz. System.Globalization.CultureInfo.

Bu öznitelik auto olarak da ayarlanabilir.

Alt Öğeler

Yok.

Üst Öğeler

Öge

Açyklama

configuration

Ortak dil çalıştırma modülü ile .NET Framework uygulamaları tarafından kullanılan bütün yapılandırma dosyalarında yer alması gereken kök ögeyi belirtir.

system.web

ASP.NET yapılandırma bölümünün kök ögesini belirler.

Açıklamalar

Sunucu veya uygulama fileEncoding öznitelik ayarı UTF-16 kullanacak biçimde yapılandırılmışsa ve UTF-16 yapılandırma dosyasının kapsamı içindeki bir .aspx sayfası için kullanılan kodlama değil ise, istemci tarayıcısına gönderilen çıkış bozuk olur ve büyük olasılıkla sayfanın kaynak kodunu görüntüler. Yapılandırılmış fileEncoding değerinin sayfa içinde kullanılan kodlamayla eşleştiğinden emin olun.

Varsayılan Yapılandırma

Aşağıdaki varsayılan globalization ögesi Machine.config dosyası veya kök Web.config dosyasında tam olarak yapılandırılmamıştır. Ancak bu, uygulamanın varsayılan yapılandırmasıdır.

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

Örnek

Aşağıdaki kod örneğinde, bir ASP.NET uygulaması için varsayılan istek ve yanıt kodlamasının nasıl belirtildiği gösterilmektedir.

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

Öğe Bilgileri

Yapılandırma bölümü işleyicisi

System.Web.Configuration.GlobalizationSection

Yapılandırma üyesi

SystemWebSectionGroup.Globalization

Yapılandırılabilir konumlar

Machine.config

Kök düzeyinde Web.config

Uygulama düzeyinde Web.config

Sanal veya fiziksel dizin düzeyinde Web.config

Gereksinimler

Microsoft Internet Information Services (IIS) sürüm 5.0, 5.1 veya 6.0

Microsoft .NET Framework sürüm 1.0, 1.1 veya 2.0

Microsoft Visual Studio 2003 veya Visual Studio 2005

Ayrıca bkz.

Görevler

Nasıl Yapılır: ASP.NET Yapılandırması kilitlemek Ayarlar

Başvuru

system.web Ögesi (ASP.NET Ayarlar Şeması)

<configuration> Öğesi

System.Configuration

System.Web.Configuration

Kavramlar

Taban şifreleme Türler

ASP.NET yapılandırmasına genel bakış

ASP.NET web sunucusu Denetimler ve tarayıcı yetenekleri

ASP.NET Yapılandırması güvenliğini sağlama

ASP.NET Yapılandırması senaryoları

Diğer Kaynaklar

ASP.NET Yapılandırması dosyalarının

ASP.NET Yapılandırma Ayarları

Genel Yapılandırma Ayarları (ASP.NET)

ASP.NET Yapılandırması API