globalization, élément (Schéma des paramètres ASP.NET)
[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]
Configure les paramètres de globalisation d'une application.
<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"/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut |
Description |
|---|---|
culture |
Attribut facultatif. Spécifie la culture par défaut pour le traitement des demandes Web entrantes. Pour connaître les chaînes de culture valides, consultez System.Globalization.CultureInfo. Cet attribut peut également avoir la valeur auto. |
enableClientBasedCulture |
Attribut facultatif. Cet attribut n'est pas utilisé à l'heure actuelle. |
fileEncoding |
Attribut facultatif. Spécifie l'encodage par défaut pour l'analyse des fichiers .aspx, .asmx et .asax. Les fichiers Unicode et UTF-8 enregistrés avec le préfixe byte order mark sont automatiquement reconnus, indépendamment de la valeur de cet attribut. |
requestEncoding |
Attribut facultatif. Spécifie l'encodage supposé de chaque demande entrante, y compris les données publiées et la chaîne de requête. Si la demande entrante possède un en-tête de demande qui contient un attribut Accept-Charset, il se substitue à cet attribut dans la configuration. L'encodage par défaut est UTF-8, spécifié dans la section globalization du fichier Machine.config qui a été créé lors de l'installation du .NET Framework. Si l'encodage des demandes n'est pas spécifié dans un fichier Machine.config ou Web.config, les paramètres régionaux de l'ordinateur s'appliquent. Dans les applications à serveur unique, cet attribut et l'attribut responseEncoding doivent être identiques. Dans les cas moins fréquents (des applications à plusieurs serveurs où les encodages serveur par défaut sont différents), vous pouvez varier l'encodage des demandes et des réponses à l'aide des fichiers locaux Web.config. |
responseEncoding |
Attribut facultatif. Spécifie l'encodage du contenu des réponses. L'encodage par défaut est UTF-8, spécifié dans la section globalization du fichier Machine.config qui a été créé lors de l'installation du .NET Framework. Si l'encodage des réponses n'est pas spécifié dans un fichier Machine.config ou Web.config, les paramètres régionaux de l'ordinateur s'appliquent. Dans les applications à serveur unique, cet attribut et l'attribut responseEncoding doivent être identiques. Dans les cas moins fréquents (des applications à plusieurs serveurs où les encodages serveur par défaut sont différents), vous pouvez varier l'encodage des demandes et des réponses à l'aide des fichiers locaux Web.config. |
uiCulture |
Attribut facultatif. Spécifie la culture par défaut pour le traitement des recherches de ressources dépendant des paramètres régionaux. Pour connaître les chaînes de culture valides, consultez System.Globalization.CultureInfo. Cet attribut peut également avoir la valeur auto. |
Éléments enfants
Aucun
Éléments parents
Élément |
Description |
|---|---|
configuration |
Spécifie l'élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
system.web |
Spécifie l'élément racine de la section de configuration ASP.NET. |
Notes
Si le paramètre de l'attribut fileEncoding du serveur ou de l'application est configuré pour utiliser UTF-16 et que l'encodage UTF-16 n'est pas utilisé pour une page .aspx dans la portée du fichier de configuration, la sortie envoyée au navigateur client est endommagée et risque d'afficher le code source de la page. Veillez à ce que la valeur de fileEncoding configurée corresponde à l'encodage utilisé dans la page.
Configuration par défaut
L'élément globalization par défaut n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Toutefois, il s'agit de la configuration par défaut retournée par l'application.
<globalization requestEncoding="utf-8"
responseEncoding="utf-8"
fileEncoding=""
culture=""
uiCulture=""
enableClientBasedCulture="false"
responseHeaderEncoding="utf-8"
resourceProviderFactoryType=""
enableBestFitResponseEncoding="false" />
Exemple
L'exemple de code suivant montre comment spécifier l'encodage des demandes et des réponses par défaut pour une application ASP.NET.
<configuration>
<system.web>
<globalization
requestEncoding="iso-8859-1"
responseEncoding="iso-8859-1"/>
</system.web>
</configuration>
Informations sur les éléments
Gestionnaire de section de configuration |
|
Membre de configuration |
|
Emplacements configurables |
Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique |
Configuration requise |
Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 Microsoft .NET Framework version 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005 |
Voir aussi
Tâches
How to: Lock ASP.NET Configuration Settings
Référence
system.web, élément (Schéma des paramètres ASP.NET)
Concepts
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Autres ressources
Paramètres de configuration ASP.NET