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

Establece los valores de configuración HTTP de ASP.NET en tiempo de ejecución que determinan cómo se procesa una solicitud de una aplicación ASP.NET.

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

<httpRuntime
   executionTimeout = "HH:MM:SS" 
   maxRequestLength = "number" 
   requestLengthDiskThreshold = "number" 
   useFullyQualifiedRedirectUrl = "[True|False]" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   appRequestQueueLimit = "number"
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   apartmentThreading = "[True|False]"
   requireRootedSaveAsPath = "[True|False]"
   enable = "[True|False]" 
   sendCacheControlHeader = "[True|False]" 
   shutdownTimeout = "HH:MM:SS"
   delayNotificationTimeout = "HH:MM:SS"
   waitChangeNotification = "number" 
   maxWaitChangeNotification = "number" 
   enableHeaderChecking = "[True|False]" 
/>

Atributos y elementos

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción

apartmentThreading

Atributo Boolean opcional.

Habilita los subprocesos de apartamento para la compatibilidad con ASP clásica.

Este atributo es nuevo en la versión 2.0 de .NET Framework. El valor predeterminado es False.

appRequestQueueLimit

Atributo Int32 opcional.

Especifica el número máximo de solicitudes que ASP.NET coloca en la cola de la aplicación. Cuando no hay suficientes subprocesos libres para procesar las solicitudes, éstas se dejan en una cola. Las solicitudes entrantes se rechazarán con el mensaje de error "503 - Server Too Busy" (servidor ocupado) cuando la cola supere el límite especificado en este atributo.

El valor predeterminado es 5000.

Nota

En las versiones 1.0 y 1.1 de .NET Framework, el valor predeterminado es 100.

delayNotificationTimeout

Atributo TimeSpan opcional.

Especifica el tiempo de espera para retrasar las notificaciones.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es "00:00:05" (5 segundos).

enable

Atributo Boolean opcional.

Especifica si el dominio de aplicación está habilitado para aceptar las solicitudes entrantes en el nodo actual y en los nodos secundarios. Si su valor es False, la aplicación está desactivada.

El valor predeterminado es True.

enableHeaderChecking

Atributo Boolean opcional.

Especifica si ASP.NET debe comprobar si el encabezado de la solicitud sufre posibles ataques de inyección. Si se detecta un ataque, ASP.NET responde con un error.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es True.

enableKernelOutputCache

Atributo Boolean opcional.

Especifica si está habilitado el almacenamiento en la caché de resultados. Este atributo es relevante sólo si están instalados los Servicios de Microsoft Internet Information Server (IIS) 6.0 o posterior. La configuración del almacenamiento en la caché de resultados y el tipo de solicitud determinan si el contenido puede almacenarse en caché.

Para almacenar una respuesta en la memoria caché, deben cumplirse los siguientes criterios:

  • El almacenamiento en caché debe habilitarse explícitamente mediante una directiva de página o la API de almacenamiento en caché.

  • El almacenamiento en caché debe tener una directiva de caducidad de modo que la memoria del núcleo sepa cuándo debe descartar la respuesta.

  • El almacenamiento en caché no tiene encabezados ni parámetros variables.

  • La autenticación no es necesaria.

El valor predeterminado es True.

enableVersionHeader

Atributo Boolean opcional.

Especifica si ASP.NET debe generar un encabezado de versión. Microsoft Visual Studio 2005 usa este atributo para determinar qué versión de ASP.NET se está utilizando. No es necesario para los sitios de producción y se puede deshabilitar.

Nota

Este atributo no está disponible en la versión 1.0 de .NET Framework.

El valor predeterminado es True.

executionTimeout

Atributo TimeSpan opcional.

Especifica, en segundos, el tiempo máximo durante el cual una solicitud puede ejecutarse antes de que ASP.NET la cierre automáticamente.

Este tiempo de espera sólo se aplica si el atributo de depuración del elemento compilation tiene el valor False. Para evitar que la aplicación se cierre durante la depuración, no establezca este tiempo de espera en un valor alto.

Nota

En las versiones 1.0 y 1.1 de .NET Framework, el valor predeterminado es 90.

El valor predeterminado es "00:01:50" (110 segundos).

maxRequestLength

Atributo Int32 opcional.

Especifica, en KB, el límite del umbral del almacenamiento en búfer de las secuencias de entrada. Este límite puede usarse para los ataques de denegación de servicio que se producen, por ejemplo, cuando los usuarios envían archivos de gran tamaño al servidor.

El valor predeterminado es 4096 (4 MB).

maxWaitChangeNotification

Atributo Int32 opcional.

Especifica el número máximo de segundos que se debe esperar desde la primera notificación de cambios del archivo antes de reiniciar AppDomain para una nueva solicitud. Establezca el valor de este atributo en un número mayor que el tiempo que tardan los procesos de copia de archivo en finalizar. Las notificaciones de cambios del archivo se combinan basándose en el valor de este atributo y del atributo waitChangeNotification.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es 0.

minFreeThreads

Atributo Int32 opcional.

Especifica el número mínimo de subprocesos libres para permitir la ejecución de nuevas solicitudes. ASP.NET mantiene libre el número especificado de subprocesos para atender las solicitudes que requieran subprocesos adicionales para completar su procesamiento.

El valor predeterminado es 8.

minLocalRequestFreeThreads

Atributo Int32 opcional.

Especifica el número mínimo de subprocesos libres que ASP.NET mantiene disponibles para permitir la ejecución de nuevas solicitudes locales. El número especificado de subprocesos se mantiene reservado para las solicitudes procedentes del host local, en previsión de que algunas generen solicitudes secundarias al host local durante su procesamiento. Esto ayuda a evitar un posible interbloqueo con reentrada recursiva en el servidor Web.

El valor predeterminado es 4.

requestLengthDiskThreshold

Atributo Int32 opcional.

Especifica, en bytes, el límite del umbral del almacenamiento en búfer de las secuencias de entrada. Este valor no debe sobrepasar el valor del atributo maxRequestLength.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es 256.

requireRootedSaveAsPath

Atributo Boolean opcional.

Especifica si el parámetro filename de un método SaveAs debe ser una ruta de acceso absoluta. El proceso de ASP.NET debe tener permiso para crear archivos en la ubicación especificada.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es True.

sendCacheControlHeader

Atributo Boolean opcional.

Especifica si se envía un encabezado de control de caché; su valor se establece en Private de manera predeterminada. Si su valor es True, estará desactivado el almacenamiento en caché en el cliente.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es True.

shutdownTimeout

Atributo TimeSpan opcional.

Especifica el número de minutos que se conceden al proceso de trabajo para que se cierre por sí mismo. Una vez transcurrido este plazo, ASP.NET cierra el proceso de trabajo.

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es "00:01:30" (90 segundos).

useFullyQualifiedRedirectUrl

Atributo Boolean opcional.

Especifica si las redirecciones en el cliente son completas con el formato "http://servidor/ruta de acceso", lo cual es necesario para algunos controles móviles, o si en su lugar se envían al cliente redirecciones relativas. Si su valor es True, todas las redirecciones no completas se convierten automáticamente en completas.

Nota

Si su valor es False, puede que algunos exploradores tengan problemas al cargar páginas en sesiones sin cookies.

El valor predeterminado es False.

waitChangeNotification

Atributo Int32 opcional.

Especifica el tiempo, en segundos, que se debe esperar hasta otra notificación de cambios del archivo antes de reiniciar AppDomain. Establezca este atributo en un número mayor que el tiempo que transcurre entre las actualizaciones de dos notificaciones de cambios de la copia de archivo. Las notificaciones de cambios del archivo se combinan basándose en el valor de este atributo y del atributo maxWaitChangeNotification .

Este atributo es nuevo en la versión 2.0 de .NET Framework.

El valor predeterminado es 0 segundos.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Descripción

configuration

Elemento raíz requerido 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 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 httpRuntime establece los valores de configuración HTTP de ASP.NET en tiempo de ejecución que determinan cómo se procesa una solicitud de una aplicación ASP.NET. .NET Framework proporciona varios hosts en tiempo de ejecución, incluido el host en tiempo de ejecución de ASP.NET. Cuando entra una solicitud, ASP.NET carga el motor en tiempo de ejecución en el proceso que debe controlar la solicitud. ASP.NET crea también un dominio de aplicación para cada aplicación Web que se vaya a ejecutar en un servidor Web.

Configuración predeterminada

El siguiente elemento httpRuntime 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.

<httpRuntime 
   executionTimeout="110"
   maxRequestLength="4096"
   requestLengthDiskThreshold="256"
   useFullyQualifiedRedirectUrl="false"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   appRequestQueueLimit="5000"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   requireRootedSaveAsPath="true"
   enable="true"
   shutdownTimeout="90"
   delayNotificationTimeout="5"
   waitChangeNotification="0"
   maxWaitChangeNotification="0"
   requestPriority="Normal"
   enableHeaderChecking="true"
   sendCacheControlHeader="true"
   apartmentThreading="false"
/>

Ejemplo

En el ejemplo de código siguiente se muestra cómo especificar los parámetros HTTP del motor en tiempo de ejecución para una aplicación ASP.NET.

<configuration>
  <system.web>
  <httpRuntime maxRequestLength="4000"
    enable = "True"
    idleTimeOut = "15"
    requestLengthDiskThreshold="512
    useFullyQualifiedRedirectUrl="True"
    executionTimeout="45"
    versionHeader="1.1.4128"/>
  </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

HttpRuntimeSection

Miembro de configuración

HttpRuntime

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

.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 system.web (Esquema de configuración de ASP.NET)
Elemento configuration (Esquema de configuración general)
System.Configuration
System.Web.Configuration
HttpRuntimeSection
HttpRuntime

Conceptos

Almacenar en caché páginas ASP.NET
Jerarquía de archivos y herencia de la configuración de ASP.NET
Proteger la configuración de ASP.NET
Escenarios de 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