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.
<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. .gif "Nota") 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:
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 |
|
Miembro de configuración |
|
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
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)
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