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

Artículo
08/10/2011

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.

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

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los 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. Este atributo es nuevo en la versión 2.0 de .NET Framework. 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.
clientIDMode	Especifica el algoritmo que se utiliza para generar valores ClientID para los controles. El valor predeterminado es Predictable. El valor predeterminado del control es Inherit. Por tanto, la configuración ClientIDMode de la página determina el algoritmo predeterminado para los controles de una página. Un valor predeterminado diferente se puede establecer en la directiva @ Page de la página o en la directiva @ Control de un control de usuario. Para obtener más información acerca de los algoritmos, vea ClientIDMode y Identificación de controles de servidor web ASP.NET.
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 tipo predeterminado es Always. ValorDescripción Always Siempre debe compilarse la página. Auto ASP.NET no compilará la página, si es posible. Never Nunca debe compilarse dinámicamente la página o control. Si una página contiene un bloque de script o una construcción de código que precisa compilación, ASP.NET devolverá un error y la página no se ejecutará.
controlRenderingCompatibilityVersion	Especifica si los controles deben representar HTML como se hacía en una versión anterior de ASP.NET o como se hace en la versión actual. Nota La clase controlRenderingCompatibilityVersion es nueva en ASP.NET 4.Establecerlo en el número de versión actual tiene el mismo efecto que no establecerlo.En cualquier caso, los controles representan el HTML como se diseñó para la versión actual.La versión anterior en la que se puede establecer este atributo es 3.5. Para obtener más información, vea las propiedades PagesSection.ControlRenderingCompatibilityVersion y Control.RenderingCompatibility.
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 tipo predeterminado es False.
masterPageFile	Atributo String opcional. Especifica la ruta de acceso a la página maestra 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 tipo 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 permite 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 la navegación inteligente. La navegación inteligente requieren Microsoft Internet Explorer 5.5 o una versión posterior. La habilitación de la navegación inteligente 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 desusado en favor del atributo maintainScrollPositionOnPostBack. El tipo 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 tipo 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 en tiempo de compilación a otros tipos de etiqueta.
ignoreDeviceFilters	Define una colección de elementos de dispositivo que el explorador debe omitir cuando se representa la página. Para obtener más información, vea IgnoreDeviceFilters.

Elementos primarios

Elemento	Descripción
configuration	Es el elemento raíz necesario de cada archivo de configuración que utilizan Common Language Runtime y las aplicaciones basadas en .NET Framework.
system.web	Especifica el elemento raíz de los valores de configuración ASP.NET en 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 maestra 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" 
   clientIDMode="AutoID" 
   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 de raíz Web.config del nivel de aplicación Web.config del nivel de directorio virtual o físico
Requisitos	Microsoft Internet Information Services (IIS) versiones 5.0 o posteriores .NET Framework versión 1.0 o posteriores Microsoft Visual Studio 2003 o posterior

Vea también

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

Referencia

Conceptos

Otros recursos

Recursos adicionales