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

Define globalmente los valores de configuración específicos de la página, como las directivas ASP.NET para las páginas y los controles que están dentro del ámbito del archivo de configuración.

Elemento configuration (Esquema de configuración general)
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento pages (Esquema de configuración de ASP.NET)

<pages     
   buffer="[True|False]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   smartNavigation="[True|False]"
   autoEventWireup="[True|False]"
   pageBaseType="typename, assembly"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   masterPageFile="file path" 
   theme="string"
   styleSheetTheme="string"
   maxPageStateFieldLength="number" 
   compilationMode="[Always|Auto|Never]" 
   pageParserFilterType="string" 
   viewStateEncryptionMode="[Always|Auto|Never]" 
   maintainScrollPositionOnPostBack="[True|False]" 
   asyncTimeout="number"
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
</pages>

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción

asyncTimeout

Atributo TimeSpan opcional.

Especifica el número de segundos que deben transcurrir hasta que un controlador asincrónico finalice durante el procesamiento asincrónico.

Se trata de un atributo nuevo en .NET Framework, versión 2.0.

El valor predeterminado es "0:00:45" (45 segundos).

autoEventWireup

Atributo Boolean opcional.

Especifica si los eventos de página se habilitan automáticamente. Es decir, si se produce la conexión automática de eventos, lo que significa que el sistema asociará automáticamente los métodos de una firma determinada (por ejemplo, page_Load). Para obtener más información, vea Modelo de eventos de control de servidor Web ASP.NET.

El valor predeterminado es True.

buffer

Atributo Boolean opcional.

Especifica si el recurso de dirección URL utiliza un búfer de respuestas.

El valor predeterminado es True.

compilationMode

Atributo CompilationMode opcional.

Especifica si un control o una página de ASP.NET debe compilarse en tiempo de ejecución.

El atributo compilationMode es nuevo en .NET Framework 2.0. Este atributo puede tener uno de los valores siguientes: El valor predeterminado es Always.

Valor Descripción

Always

La página debe compilarse siempre.

Auto

Si es posible, ASP.NET no compilará la página.

Never

Nunca se debe compilar dinámicamente la página o el control.

Si una página contiene un bloque de secuencia de comandos o una construcción de código que precisa compilación, ASP.NET devolverá un error y la página no se ejecutará.

enableEventValidation

Especifica si las paginas y los controles validan la devolución de datos y los eventos de devolución de llamada. El valor predeterminado es True.

enableSessionState

Atributo String opcional.

Especifica los requisitos de estado de sesión para los recursos que están dentro del ámbito del archivo de configuración.

El atributo enableSessionState puede tener uno de los valores siguientes: El valor predeterminado es True.

Valor Descripción

False

Indica que el estado de la sesión está deshabilitado.

ReadOnly

Indica que el estado de la sesión no es modificable.

True

Indica que el estado de la sesión está habilitado.

enableViewState

Atributo Boolean opcional.

Especifica si el estado de vista está habilitado y se mantiene en todas las solicitudes de páginas.

El valor predeterminado es True.

enableViewStateMac

Atributo Boolean opcional.

Especifica si ASP.NET debe ejecutar un código de autenticación de mensajes (MAC) en el estado de vista de la página cuando el cliente la devuelva. Si el valor es True, se comprueba el estado de vista cifrado para asegurarse de que no se ha manipulado en el cliente.

El valor predeterminado es True.

maintainScrollPositionOnPostBack

Atributo Boolean opcional.

Especifica si el usuario debe devolverse a la misma posición en el explorador cliente cuando las páginas se devuelven al servidor. Si su valor es False, el usuario vuelve a la parte superior de la página cuando se produce una devolución de datos.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es False.

masterPageFile

Atributo String opcional.

Especifica la ruta de acceso a la página principal respecto del archivo de configuración local. Las páginas cuyo atributo masterPageFile tenga el valor True deben contener un control Content como control de nivel superior.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es una cadena vacía ("").

maxPageStateFieldLength

Atributo Int32 opcional.

Especifica la longitud máxima del campo de estado de la página, en caracteres. Si se establece en un número positivo, el campo de estado de vista que se envía al explorador cliente se divide en fragmentos, cada uno de los cuales es inferior al tamaño especificado en el atributo maxPageStateFieldLength. Si se establece en un número negativo, el campo de estado de vista no se debería dividir en fragmentos.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es "-1".

pageBaseType

Atributo String opcional.

Especifica la base que se va a utilizar cuando las páginas sólo sean independientes. Lo reemplaza el atributo inherits en un archivo independiente.

El valor predeterminado es "System.Web.UI.Page."

pageParserFilterType

Atributo String opcional.

Especifica el nombre de tipo de un filtro utilizado por el analizador de ASP.NET para determinar si se admite un elemento en la página en tiempo de análisis. El filtro debe derivarse de la clase PageParserFilter.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es una cadena vacía ("").

smartNavigation

Atributo Boolean opcional.

Especifica si están habilitados los desplazamientos inteligentes. Los desplazamientos inteligentes requieren Microsoft Internet Explorer 5.5 o una versión posterior. La habilitación de los desplazamientos inteligentes ofrece al usuario las siguientes ventajas:

  • Se eliminan los destellos del desplazamiento.

  • Se conserva la posición de desplazamiento entre páginas.

  • Se mantiene el foco sobre elementos entre páginas.

  • El último estado de la página es el único estado que el historial mantiene en el explorador.

Este atributo es nuevo en .NET Framework 2.0, pero ha quedado obsoleto en favor del atributo maintainScrollPositionOnPostBack.

El valor predeterminado es False.

styleSheetTheme

Atributo String opcional.

Especifica el nombre de la carpeta del "tema con nombre" que se utilizará para aplicar el tema antes de las declaraciones de controles, a diferencia del atributo de tema, que define el tema que se aplicará después de la declaración del control.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es una cadena vacía ("").

theme

Atributo String opcional.

Especifica el nombre del tema utilizado en las páginas que están dentro del ámbito del archivo de configuración. El tema especificado debe existir como aplicación o como tema global. Si el tema no existe, se desencadena una excepción HttpException.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es una cadena vacía ("").

userControlBaseType

Atributo String opcional.

Especifica la base que se va a utilizar cuando las páginas sólo sean independientes.

El valor predeterminado es "System.Web.UI.UserControl".

validateRequest

Atributo Boolean opcional.

Indica que ASP.NET examina todas las entradas del explorador en busca de datos potencialmente peligrosos. Si el valor es True, la validación de las solicitudes se realiza comparando todos los datos de entrada con una lista de valores potencialmente peligrosos. Si se encuentra una correspondencia, ASP.NET desencadena una excepción HttpRequestValidationException.

El valor predeterminado es True.

viewStateEncryptionMode

Atributo ViewStateEncryptionMode opcional.

Especifica el modo de cifrado del estado de vista. La propiedad ViewStateEncryptionMode reemplaza este atributo, que se establece en el archivo de configuración.

Este atributo puede tener uno de los valores siguientes:

Valor Descripción

Always

El estado de vista siempre está cifrado.

Auto

El estado de vista se cifra si un control lo solicita.

Never

El estado de vista no se cifra nunca, ni siquiera cuando lo solicita un control.

Este atributo es nuevo en .NET Framework 2.0.

El valor predeterminado es Auto.

Elementos secundarios

Elemento Descripción

controls

Define una colección de directivas de registro y los espacios de nombres en los que residen los prefijos de etiqueta.

namespaces

Define una colección de directivas de importación que se van a usar en la precompilación del ensamblado.

tagMapping

Define una colección de tipos de etiqueta que se reasignan a otros tipos de etiqueta en el tiempo de compilación.

Elementos primarios

Elemento Descripción

configuration

Es el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

system.web

Especifica el elemento raíz de los valores de configuración de ASP.NET de un archivo de configuración y contiene elementos de configuración que configuran las aplicaciones Web ASP.NET y controlan el comportamiento de las aplicaciones.

Comentarios

El elemento pages define las opciones de configuración específicas de la página. Esta sección de configuración admite la configuración global de algunas directivas de controles y páginas de ASP.NET en todas las páginas y controles del ámbito del archivo de configuración. Se incluyen las siguientes directivas de nivel de página, que especifican los valores utilizados por los compiladores de páginas y controles de usuario al procesar archivos de controles de usuario (.acsx) y páginas de formularios Web Forms (.aspx) de ASP.NET:

El elemento pages también proporciona compatibilidad para asignar tipos de etiqueta a otros tipos de etiqueta en tiempo de ejecución a través del elemento tagMapping.

Nota

Al agregar una directiva @ Page a una página principal no se puede utilizar la misma declaración de directiva en las páginas que dependan de ella. En su lugar, utilice el elemento de configuración pages para definir globalmente las directivas de página.

Configuración predeterminada

El siguiente elemento pages predeterminado no se configura explícitamente en el archivo Machine.config o en el archivo Web.config raíz. Sin embargo, una aplicación devuelve la configuración predeterminada. Los espacios de nombres y los controles se agregan al archivo Web.config raíz.

<pages 
   buffer="true" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

Ejemplo

En el ejemplo de código siguiente se muestra cómo especificar varios valores de configuración de página.

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

PagesSection

Miembro de configuración

Pages

Page

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos   

Servicios de Microsoft Internet Information Server (IIS) 5.0, 5.1 ó 6.0

.NET Framework 1.0, 1.1 ó 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Configurar directorios concretos mediante la configuración de la ubicación
Cómo: Bloquear los valores de configuración de ASP.NET

Referencia

Elemento configuration (Esquema de configuración general)
Elemento controls para pages (Esquema de configuración de ASP.NET)
Elemento namespaces para pages (Esquema de configuración de ASP.NET)
Elemento tagMapping para pages (Esquema de configuración de ASP.NET)
Elemento system.web (Esquema de configuración de ASP.NET)
@ Page
System.Configuration
System.Web.Configuration
Page
PagesSection

Conceptos

Jerarquía de archivos y herencia de la configuración de ASP.NET
Proteger la configuración de ASP.NET

Otros recursos

Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Configurar aplicaciones ASP.NET
API de configuración de ASP.NET