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

Artículo
10/07/2008

Actualización: noviembre 2007

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. ValorDescripció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. ValorDescripció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: ValorDescripció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:

La directiva @ Page (@ Page).
La directiva @ Import (@ Import) a través del elemento secundario namespaces.
La directiva @ Register (@ Register) a través del elemento secundario controls.

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

Compartir a través de

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

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales