Compartir a través de


HttpRuntimeSection (clase)

Configura valores en tiempo de ejecución HTTP de ASP.NET que determinan cómo se procesa una solicitud para una aplicación ASP.NET determinada.

Sintaxis

class HttpRuntimeSection : ConfigurationSection  

Métodos

En la tabla siguiente se enumeran los métodos que expone la clase HttpRuntimeSection.

Nombre Descripción
GetAllowDefinition (Se hereda de ConfigurationSection).
GetAllowLocation (Se hereda de ConfigurationSection).
RevertToParent (Se hereda de ConfigurationSection).
SetAllowDefinition (Se hereda de ConfigurationSection).
SetAllowLocation (Se hereda de ConfigurationSection).

Propiedades

La siguiente tabla muestra las propiedades que expone la clase HttpRuntimeSection.

Nombre Descripción
ApartmentThreading Un valor opcional boolean de lectura y escritura. true si el subproceso de apartamento está habilitado para la compatibilidad con ASP clásica; de lo contrario, false. El valor predeterminado es false. Nota: Esta propiedad es nueva en .NET Framework 2.0.
AppRequestQueueLimit Valor sint32 de lectura y escritura opcional que especifica el número máximo de solicitudes que ASP.NET mantiene en cola para la aplicación. El valor predeterminado es 5000. Nota: Para las versiones 1.0 y 1.1 de .NET Framework, el valor predeterminado es 100.

Cuando no hay suficientes subprocesos libres para procesar una solicitud, las solicitudes se ponen en cola. Cuando el número de solicitudes de la cola supera el límite especificado en esta propiedad, las solicitudes entrantes se rechazan con el error "503: Servidor muy ocupado".
DelayNotificationTimeout Valor de lectura y escritura datetime opcional que especifica el tiempo de espera para retrasar las notificaciones. El valor predeterminado es 5 segundos. Nota: Esta propiedad es nueva en .NET Framework 2.0.
Enable Un valor opcional boolean de lectura y escritura. true si el dominio de aplicación (AppDomain) está habilitado para aceptar solicitudes entrantes en los niveles de nodo actual y secundario; de lo contrario, false. El valor predeterminado es true. Si false, la aplicación se desactiva de forma eficaz.
EnableHeaderChecking Un valor opcional boolean de lectura y escritura. true si ASP.NET debe comprobar el encabezado de solicitud para detectar posibles ataques por inyección; de lo contrario, false. El valor predeterminado es true. Si se detecta un ataque, ASP.NET responde con un error. Nota: Esta propiedad es nueva en .NET Framework 2.0.
EnableKernelOutputCache Un valor opcional boolean de lectura y escritura. Es true si el almacenamiento en la caché de resultados está habilitado; en caso contrario, es false. El valor predeterminado es true.

Este atributo solo es relevante cuando se instala IIS 6.0 o 7.0. La configuración del almacenamiento en caché de salida y el tipo de solicitud determinan si el contenido se puede almacenar en caché.

Para almacenar una respuesta en caché, debe asegurarse de que se cumplen los siguientes criterios:

— El almacenamiento en caché debe habilitarse explícitamente mediante una directiva de página o mediante la API de almacenamiento en caché.
— El almacenamiento en caché debe tener una directiva de expiración para que el kernel reconozca cuándo descartar la respuesta.
— El almacenamiento en caché no tiene ningún encabezado o parámetro de variable.
— No se requiere autenticación.
EnableVersionHeader Un valor opcional boolean de lectura y escritura. true si ASP.NET debe generar un encabezado de versión; de lo contrario, false. El valor predeterminado es true.

Visual Studio 2005 usa esta propiedad para determinar qué versión de ASP.NET está en uso. Esta propiedad no es necesaria para los sitios de producción y se puede deshabilitar.
ExecutionTimeout Valor datetime de lectura y escritura opcional que especifica el tiempo máximo que se permite ejecutar una solicitud antes de que ASP.NET la detenga automáticamente. El valor predeterminado es de 1 minuto y 50 segundos.

Este tiempo de espera solo se aplica si la propiedad Debug de la clase CompilationSection es false. Para evitar que la aplicación se apague mientras se depura, no establezca este tiempo de espera en un valor grande.
Location (Se hereda de ConfigurationSection). Una propiedad clave.
MaxRequestLength Valor sint32 opcional de lectura y escritura que especifica el límite, en kilobytes, para el umbral de almacenamiento en búfer del flujo de entrada. El valor predeterminado es 4096 (4 MB).

Puede usar este límite para evitar ataques de denegación de servicio causados, por ejemplo, por los usuarios que publican archivos grandes en el servidor.
MaxWaitChangeNotification Valor sint32 de lectura y escritura opcional que especifica el tiempo máximo de espera, en segundos, después de la primera notificación de cambio del archivo antes de que el dominio de aplicación se reinicie para una nueva solicitud. El valor predeterminado es 0.

Establezca esta propiedad en un número mayor que el tiempo necesario para completar los procesos de copia de archivos. Las notificaciones de cambio del archivo se combinan en función del valor de esta propiedad y de la propiedad WaitChangeNotification. Nota: Esta propiedad es nueva en .NET Framework 2.0.
MinFreeThreads Valor sint32 opcional de lectura y escritura que especifica el número mínimo de subprocesos que ASP.NET mantiene disponibles para las solicitudes que requieren subprocesos adicionales para completar el procesamiento. El valor predeterminado es 8.
MinLocalRequestFreeThreads Valor sint32 opcional de lectura y escritura que especifica el número mínimo de subprocesos que ASP.NET mantiene disponibles para las solicitudes locales que requieren subprocesos adicionales para completar el procesamiento. El valor predeterminado es 4. Nota: El número especificado de subprocesos está reservado para las solicitudes que proceden del host local, en caso de que algunas de estas solicitudes emitan solicitudes secundarias durante el procesamiento. Esto ayuda a prevenir que se produzca un posible interbloqueo con una reentrada recursiva en el servidor Web.
Path (Se hereda de ConfigurationSection). Una propiedad clave.
RequestLengthDiskThreshold Valor sint32 opcional de lectura y escritura que especifica, en bytes, el límite para el umbral de almacenamiento en búfer del flujo de entrada. El valor predeterminado es 256.

Este valor no debe superar el valor de la propiedad MaxRequestLength. Nota: Esta propiedad es nueva en .NET Framework 2.0.
RequireRootedSaveAsPath Un valor opcional boolean de lectura y escritura. true si el parámetro filename de un método SaveAs debe ser una ruta de acceso absoluta; de lo contrario, false. El valor predeterminado es true.

El proceso de ASP.NET debe tener permiso para crear archivos en la ubicación especificada. Nota: Esta propiedad es nueva en .NET Framework 2.0.
SectionInformation (Se hereda de ConfigurationSection).
SendCacheControlHeader Un valor opcional boolean de lectura y escritura. true si un encabezado de control de caché establecido en Privado se envía de forma predeterminada; de lo contrario, false. Si true, el almacenamiento en caché del lado cliente está deshabilitado. El valor predeterminado es true. Nota: Esta propiedad es nueva en .NET Framework 2.0.
ShutdownTimeout Valor datetime opcional de lectura y escritura que especifica el tiempo que se permite que un proceso de trabajo esté apagado. El valor predeterminado es de 1 minuto y 30 segundos.

Cuando expire el tiempo de espera, ASP.NET apaga el proceso de trabajo. Nota: Esta propiedad es nueva en .NET Framework 2.0.
UseFullyQualifiedRedirectUrl Un valor opcional boolean de lectura y escritura. Es true si los redireccionamientos del lado cliente son completos; en caso contrario, es false. El valor predeterminado es false.

Para calificar completamente las redirecciones del lado cliente, use el formato http://server/path. Este formato es necesario para algunos controles móviles. Si true, todas las redirecciones que no están completas se convierten automáticamente en un formato completo. Si false, las redirecciones relativas se envían al cliente. Nota: Si false, algunos exploradores pueden experimentar problemas al cargar páginas que se encuentran en sesiones sin cookies.
WaitChangeNotification Valor sint32 de lectura y escritura opcional que especifica el tiempo de espera, en segundos, para otra notificación de cambio del archivo antes de que el dominio de aplicación se reinicie. El valor predeterminado es 0.

Establezca este atributo en un número mayor que el tiempo entre las actualizaciones de dos notificaciones de cambio de copia de archivos. Las notificaciones de cambio del archivo se combinan en función del valor de esta propiedad y de la propiedad MaxWaitChangeNotification. Nota: Esta propiedad es nueva en .NET Framework 2.0.

Subclases

Esta clase no contiene subclases.

Jerarquía de herencia

ConfigurationSection

HttpRuntimeSection

Requisitos

Tipo Descripción
Remoto - IIS 7.0 en Windows Vista
- IIS 7.5 en Windows 7
- IIS 8.0 en Windows 8
- IIS 10.0 en Windows 10
Server - IIS 7.0 en Windows Server 2008
- IIS 7.5 en Windows Server 2008 R2
- IIS 8.0 en Windows Server 2012
- IIS 8.5 en Windows Server 2012 R2
- IIS 10.0 en Windows Server 2016
Producto - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF WebAdministration.mof

Consulte también

System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
ConfigurationSection (clase)
CompilationSection (clase)
CIM_DATETIME