Elemento globalization (schema delle impostazioni ASP.NET)

Articolo
08/11/2011

Configura le impostazioni di globalizzazione di un'applicazione.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
culture	Attributo facoltativo. Specifica le impostazioni cultura predefinite per l'elaborazione delle richieste Web in entrata. Per esaminare stringhe di impostazioni cultura valide, vedere System.Globalization.CultureInfo. Questo attributo può essere impostato anche su auto.
enableClientBasedCulture	Attributo facoltativo. L'attributo attualmente non viene utilizzato.
fileEncoding	Attributo facoltativo. Specifica la codifica predefinita per l'analisi dei file ASPX, ASMX e ASAX. I file Unicode e UTF-8 salvati con il prefisso byte order mark vengono automaticamente riconosciuti a prescindere dal valore dell'attributo.
requestEncoding	Attributo facoltativo. Specifica la codifica utilizzata da ciascuna richiesta in entrata, inclusi i dati inviati e la stringa di query. Se la richiesta include un'intestazione che contiene un attributo Accept-Charset, viene eseguito l'override dell'attributo nella configurazione. La codifica predefinita è UTF-8, specificata nella sezione globalization nel file Machine.config creato al momento dell'installazione di .NET Framework. Se la codifica della richiesta non è specificata in un file Machine.config o Web.config, vengono automaticamente utilizzate le impostazioni locali del computer, indicate in Impostazioni locali. Nelle applicazioni a server singolo questo attributo e l'attributo responseEncoding devono coincidere. Per il caso meno comune, ovvero quando in un'applicazione a più server le codifiche del server predefinito sono diverse, è possibile variare la codifica della richiesta e della risposta tramite i file Web.config locali.
responseEncoding	Attributo facoltativo. Specifica la codifica del contenuto delle risposte. La codifica predefinita è UTF-8, specificata nella sezione globalization nel file Machine.config creato al momento dell'installazione di .NET Framework. Se la codifica della risposta non è specificata in un file Machine.config o Web.config, vengono automaticamente utilizzate le impostazioni locali del computer, indicate in Impostazioni locali. Nelle applicazioni a server singolo questo attributo e l'attributo responseEncoding devono coincidere. Per il caso meno comune, ovvero quando in un'applicazione a più server le codifiche del server predefinito sono diverse, è possibile variare la codifica della richiesta e della risposta tramite i file Web.config locali.
uiCulture	Attributo facoltativo. Specifica le impostazioni cultura predefinite per l'elaborazione delle ricerche delle risorse che dipendono dalle impostazioni locali. Per esaminare stringhe di impostazioni cultura valide, vedere System.Globalization.CultureInfo. Questo attributo può essere impostato anche su auto.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
configuration	Specifica l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.

Note

Se l'impostazione dell'attributo fileEncoding del server o dell'applicazione, corrispondente all'uso di UTF-16 e UTF-16, non è il tipo di codifica utilizzato per le pagine aspx nell'ambito del file di configurazione, l'output inviato al browser del client risulterà danneggiato e potrebbe determinare la visualizzazione del codice sorgente della pagina. Assicurarsi che il valore di fileEncoding configurato corrisponda alla codifica utilizzata nella pagina.

Configurazione predefinita

L'elemento globalization predefinito riportato di seguito non viene configurato in modo esplicito nel file Machine.config o nel file Web.config radice. Si tratta, tuttavia, della configurazione predefinita restituita dall'applicazione.

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

Esempio

Nell'esempio di codice che segue viene illustrato come specificare la codifica predefinita per le richieste e le risposte di un'applicazione ASP.NET.

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

Informazioni sull'elemento

Gestore della sezione di configurazione	System.Web.Configuration.GlobalizationSection
Membro di configurazione	SystemWebSectionGroup.Globalization
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 Microsoft .NET Framework versione 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite

Elemento globalization (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive