Elemento globalization (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Configura le impostazioni di globalizzazione di un'applicazione.

Elemento <Configuration>
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento globalization (schema delle impostazioni ASP.NET)

<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 riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
culture	Attributo facoltativo. Specifica la lingua predefinita per l'elaborazione delle richieste Web in entrata. Per esaminare stringhe di lingua 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 internazionali del computer, indicate in Impostazioni internazionali. 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 internazionali del computer, indicate in Impostazioni internazionali. 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 la lingua predefinita per l'elaborazione delle ricerche delle risorse che dipendono dalle impostazioni internazionali. Per esaminare stringhe di lingua valide, vedere System.Globalization.CultureInfo. Questo attributo può essere impostato anche su auto.

Elementi figlio

Nessuno.

Elementi padre

Elemento	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 principale. 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à

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive