globalization, élément (Schéma des paramètres ASP.NET)

Article
09/04/2008

Mise à jour : novembre 2007

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

<configuration>, élément
system.web, élément (Schéma des paramètres ASP.NET)
globalization, élément (Schéma des paramètres 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"/>

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 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 sont automatiquement reconnus, indépendamment de la valeur de cet attribut.
requestEncoding	Attribut facultatif. 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 entrante possède un en-tête de demande qui contient un attribut Accept-Charset, il se substitue à cet attribut dans la configuration. Le codage 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 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, cet attribut et l'attribut 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	Attribut facultatif. Spécifie le codage du contenu des réponses. Le codage 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 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, cet attribut et l'attribut 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.
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 le codage 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 au codage 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 le codage 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	System.Web.Configuration.GlobalizationSection
Membre de configuration	SystemWebSectionGroup.Globalization
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

Partager via

globalization, élément (Schéma des paramètres ASP.NET)

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires