Elemento globalization (schema delle impostazioni ASP.NET)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
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 descritti gli attributi, gli elementi figlio e gli elementi 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 |
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 radice 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 |
|
Membro di configurazione |
|
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
Attività
How to: Lock ASP.NET Configuration Settings
Riferimenti
Elemento system.web (schema delle impostazioni ASP.NET)
Concetti
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Altre risorse
Impostazioni di configurazione di ASP.NET