<globalization>, élément

Article
04/11/2008

Configure les paramètres de globalisation d'une application.

<configuration>
<system.web>
<globalization>

<globalizationrequestEncoding="any valid encoding string"               responseEncoding="any valid encoding string"               fileEncoding="any valid encoding string"               culture="any valid culture string"               uiCulture="any valid culture string"/>

Attributs facultatifs

Attribut	Description
requestEncoding	Spécifie le codage supposé de chaque demande entrante, y compris les données publiées et la chaîne de requête. Si la demande est assortie d'un en-tête contenant un attribut Accept-Charset, celui-ci se substitue à l'attribut requestEncoding de la configuration. Le codage par défaut est UTF-8, spécifié dans la balise <globalization> qui figure dans le fichier Machine.config créé lors de l'installation du .NET Framework. Si le codage 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, requestEncoding et responseEncoding doivent être identiques. Dans les cas moins fréquents (des applications à plusieurs serveurs où les codages serveur par défaut sont différents), vous pouvez varier le codage des demandes et des réponses à l'aide des fichiers locaux Web.config.
responseEncoding	Spécifie le codage du contenu des réponses. Le codage par défaut est UTF-8, spécifié dans la balise <globalization> qui figure dans le fichier Machine.config créé lors de l'installation du .NET Framework. Si le codage 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, requestEncoding et responseEncoding doivent être identiques. Dans les cas moins fréquents (des applications à plusieurs serveurs où les codages serveur par défaut sont différents), vous pouvez varier le codage des demandes et des réponses à l'aide des fichiers locaux Web.config.
fileEncoding	Spécifie le codage 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` seront automatiquement reconnus, quelle que soit la valeur de fileEncoding.
culture	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, classe.
uiCulture	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, classe.

Notes

Si le paramètre d'attribut fileEncoding de serveur ou d'application est configuré pour utiliser UTF-16 et que UTF-16 n'est pas le codage utilisé pour une page .aspx dans la portée du fichier de configuration, la sortie envoyée au navigateur client sera endommagée et risque d'afficher le code source de la page. Veillez à ce que la valeur fileEncoding configurée corresponde au codage utilisé dans la page.

Exemple

L'exemple suivant spécifie le codage par défaut des demandes et des réponses pour une application ASP.NET.

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

Configuration requise

Contenu dans : <system.web>

Plate-forme Web : IIS 5.0, IIS 5.1, IIS 6.0

Fichier de configuration : Machine.config, Web.config

Gestionnaire de sections de configuration : System.Web.Configuration.GlobalizationConfigHandler

Voir aussi

Configuration ASP.NET | Schéma des paramètres ASP.NET | Codage des types de base

Partager via