Partager via

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

  • Article

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

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

Tâches

Comment : verrouiller des paramètres de configuration ASP.NET

Référence

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

<configuration>, élément

System.Configuration

System.Web.Configuration

Concepts

Encodage des types de base

Vue d'ensemble de la configuration ASP.NET

Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Autres ressources

Fichiers de configuration ASP.NET

Paramètres de configuration ASP.NET

Paramètres généraux de configuration (ASP.NET)

API de configuration ASP.NET