Elemento globalization (Esquema de configuración de ASP.NET)
Actualización: noviembre 2007
Configura las opciones de globalización de una aplicación.
Elemento <configuration>
Elemento system.web (Esquema de configuración de ASP.NET)
Elemento globalization (Esquema de configuración de 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"/>
Atributos y elementos
Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.
Atributos
Atributo |
Descripción |
|---|---|
culture |
Atributo opcional. Especifica la referencia cultural predeterminada para el procesamiento de las solicitudes Web entrantes. Para obtener cadenas de referencia cultural válidas, vea System.Globalization.CultureInfo. El valor de este atributo puede establecerse también en auto. |
enableClientBasedCulture |
Atributo opcional. Este atributo no se utiliza por el momento. |
fileEncoding |
Atributo opcional. Especifica la codificación predeterminada para el análisis de los archivos .aspx, .asmx y .asax. Los archivos Unicode y UTF-8 guardados con el prefijo byte order mark se reconocerán automáticamente, independientemente del valor de este atributo. |
requestEncoding |
Atributo opcional. Especifica la codificación supuesta de cada solicitud entrante, incluidos los datos devueltos y la cadena de consulta. Si la solicitud incluye un encabezado con un atributo Accept-Charset, prevalecerá sobre este atributo en la configuración. La codificación predeterminada es UTF-8, que se especifica en la sección globalization del archivo Machine.config creado durante la instalación de .NET Framework. Si en el archivo Machine.config o Web.config no se especifica la codificación de las solicitudes, se adoptará como codificación predeterminada la correspondiente a la configuración regional del equipo. En las aplicaciones que se ejecutan en un solo servidor, este atributo y el atributo responseEncoding deben ser iguales. En el caso, menos común, de aplicaciones que se ejecutan en varios servidores en los que las codificaciones de servidor predeterminadas sean distintas, se puede variar la codificación de solicitud y de respuesta mediante los archivos Web.config locales. |
responseEncoding |
Atributo opcional. Especifica la codificación del contenido de las respuestas. La codificación predeterminada es UTF-8, que se especifica en la sección globalization del archivo Machine.config creado durante la instalación de .NET Framework. Si en el archivo Machine.config o Web.config no se especifica la codificación de las respuestas, se adoptará como codificación predeterminada la correspondiente a la configuración regional del equipo. En las aplicaciones que se ejecutan en un solo servidor, este atributoy el atributo responseEncoding deben ser iguales. En el caso, menos común, de aplicaciones que se ejecutan en varios servidores en los que las codificaciones de servidor predeterminadas sean distintas, se puede variar la codificación de solicitud y de respuesta mediante los archivos Web.config locales. |
uiCulture |
Atributo opcional. Especifica la referencia cultural predeterminada para el procesamiento de las búsquedas de recursos dependientes de la configuración regional. Para obtener cadenas de referencia cultural válidas, vea System.Globalization.CultureInfo. El valor de este atributo puede establecerse también en auto. |
Elementos secundarios
Ninguno.
Elementos primarios
Elemento |
Descripción |
|---|---|
configuration |
Especifica el elemento raíz de cada archivo de configuración utilizado por Common Language Runtime y las aplicaciones de .NET Framework. |
system.web |
Especifica el elemento raíz de la sección de configuración de ASP.NET. |
Comentarios
Si el atributo fileEncoding del servidor o de la aplicación está configurado para usar UTF-16 y UTF-16 no es la codificación utilizada para una página .aspx en el ámbito del archivo de configuración, la respuesta enviada al explorador del cliente estará dañada y probablemente mostrará el código fuente de la página. Asegúrese de que el valor de fileEncoding configurado coincida con la codificación utilizada en la página.
Configuración predeterminada
El siguiente elemento globalization predeterminado no se configura explícitamente en el archivo Machine.config o el archivo raíz Web.config. Sin embargo, es la configuración predeterminada la que devuelve la aplicación.
<globalization requestEncoding="utf-8"
responseEncoding="utf-8"
fileEncoding=""
culture=""
uiCulture=""
enableClientBasedCulture="false"
responseHeaderEncoding="utf-8"
resourceProviderFactoryType=""
enableBestFitResponseEncoding="false" />
Ejemplo
En el ejemplo de código siguiente se muestra cómo especificar la codificación predeterminada de las solicitudes y respuestas para una aplicación ASP.NET.
<configuration>
<system.web>
<globalization
requestEncoding="iso-8859-1"
responseEncoding="iso-8859-1"/>
</system.web>
</configuration>
Información de elemento
Controlador de la sección de configuración |
|
Miembro de configuración |
|
Ubicaciones configurables |
Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorios virtuales o físicos |
Requisitos |
Servicios de Microsoft Internet Information Server (IIS) 5.0, 5.1 ó 6.0 Microsoft .NET Framework 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vea también
Tareas
Cómo: Bloquear los valores de configuración de ASP.NET
Conceptos
Información general sobre la configuración de ASP.NET
Controles de servidor Web ASP.NET y funciones del explorador
Proteger la configuración de ASP.NET
Escenarios de configuración de ASP.NET
Referencia
Elemento system.web (Esquema de configuración de ASP.NET)
Otros recursos
Archivos de configuración de ASP.NET
Opciones de configuración de ASP.NET