Elemento globalization (Esquema de configuración de ASP.NET)

Cambiar vista

<globalization>

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:

Referencia general de .NET Framework

Elemento globalization (Esquema de configuración de ASP.NET)

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 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.
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	System.Web.Configuration.GlobalizationSection
Miembro de configuración	System.Web.Configuration.SystemWebSectionGroup.Globalization
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

Etiquetas

: Agregar una etiqueta

Contenido de la comunidad

Agregar contenido nuevo

Anotaciones

Administre su perfil | MSDN Flash en Español | Contacto | Aviso legal

Atributos

Elementos secundarios

Elementos primarios

Tareas

Referencia

Conceptos

Otros recursos