Skip to content

Latest commit

 

History

History
81 lines (63 loc) · 11.8 KB

httpruntimesection-class.md

File metadata and controls

81 lines (63 loc) · 11.8 KB
title description ms.date ms.assetid
HttpRuntimeSection Class
This article contains information about syntax, methods, properties, subclasses, inheritance hierarchy, and requirements for the HttpRuntimeSection class.
10/07/2016
de71149d-7086-8952-f32a-9a233d9991ec

HttpRuntimeSection Class

Configures [!INCLUDEvstecasp] HTTP run-time settings that determine how a request is processed for a given [!INCLUDEvstecasp] application.

Syntax

class HttpRuntimeSection : ConfigurationSection  

Methods

The following table lists the methods exposed by the HttpRuntimeSection class.

Name Description
GetAllowDefinition (Inherited from ConfigurationSection.)
GetAllowLocation (Inherited from ConfigurationSection.)
RevertToParent (Inherited from ConfigurationSection.)
SetAllowDefinition (Inherited from ConfigurationSection.)
SetAllowLocation (Inherited from ConfigurationSection.)

Properties

The following table lists the properties exposed by the HttpRuntimeSection class.

Name Description
ApartmentThreading An optional read/write boolean value. true if apartment threading is enabled for classic ASP compatibility; otherwise, false. The default is false. Note: This property is new in the [!INCLUDEdnprdnlong].
AppRequestQueueLimit An optional read/write sint32 value that specifies the maximum number of requests that [!INCLUDEvstecasp] queues for the application. The default is 5000. Note: For the [!INCLUDEdnprdnshort] versions 1.0 and 1.1, the default is 100.

When there are not enough free threads to process a request, the requests are queued. When the number of requests in the queue exceeds the limit that is specified in this property, incoming requests are rejected with the error "503 - Server Too Busy".
DelayNotificationTimeout An optional read/write datetime value that specifies the time-out for delaying notifications. The default is 5 seconds. Note: This property is new in the [!INCLUDEdnprdnlong].
Enable An optional read/write boolean value. true if the application domain (AppDomain) is enabled to accept incoming requests at the current and child node levels; otherwise, false. The default is true. If false, the application is effectively turned off.
EnableHeaderChecking An optional read/write boolean value. true if [!INCLUDEvstecasp] should check the request header for potential injection attacks; otherwise, false. The default is true. If an attack is detected, [!INCLUDEvstecasp] responds with an error. Note: This property is new in the [!INCLUDEdnprdnlong].
EnableKernelOutputCache An optional read/write boolean value. true if output caching is enabled; otherwise, false. The default is true.

This attribute is relevant only when IIS 6.0 or 7.0 is installed. The output caching configuration and type of request determines whether content can be cached.

To cache a response, you must ensure that the following criteria are met:

- Caching must be explicitly enabled by a page directive or by using the caching API.
- Caching must have an expiration policy so that the kernel recognizes when to discard the response.
- Caching does not have any variable headers or parameters.
- Authentication is not required.
EnableVersionHeader An optional read/write boolean value. true if [!INCLUDEvstecasp] should output a version header; otherwise, false. The default is true.

[!INCLUDEvsprvslong] uses this property to determine which version of [!INCLUDEvstecasp] is in use. This property is not necessary for production sites and can be disabled.
ExecutionTimeout An optional read/write datetime value that specifies the maximum time that a request is allowed to execute before [!INCLUDEvstecasp] automatically stops it. The default is 1 minute, 50 seconds.

This time-out applies only if the Debug property in the CompilationSection class is false. To avoid shutting down the application while you are debugging, do not set this time-out to a large value.
Location (Inherited from ConfigurationSection.) A key property.
MaxRequestLength An optional read/write sint32 value that specifies the limit, in kilobytes, for the input stream buffering threshold. The default is 4096 (4 MB).

You can use this limit to prevent denial of service attacks that are caused, for example, by users posting large files to the server.
MaxWaitChangeNotification An optional read/write sint32 value that specifies the maximum time, in seconds, to wait after the first file change notification before the application domain restarts for a new request. The default is 0.

Set this property to a number that is greater than the length of time to complete any file copy processes. File change notifications are combined based on the value of this property and the WaitChangeNotification property. Note: This property is new in the [!INCLUDEdnprdnlong].
MinFreeThreads An optional read/write sint32 value that specifies the minimum number of threads that [!INCLUDEvstecasp] keeps available for requests that require additional threads to complete processing. The default is 8.
MinLocalRequestFreeThreads An optional read/write sint32 value that specifies the minimum number of threads that [!INCLUDEvstecasp] keeps available for local requests that require additional threads to complete processing. The default is 4. Note: The specified number of threads is reserved for requests that come from the local host, in case some of these requests issue child requests during processing. This helps to prevent a possible deadlock with recursive reentry into the Web server.
Path (Inherited from ConfigurationSection.) A key property.
RequestLengthDiskThreshold An optional read/write sint32 value that specifies, in bytes, the limit for the input stream buffering threshold. The default is 256.

This value should not exceed the value in the MaxRequestLength property. Note: This property is new in the [!INCLUDEdnprdnlong].
RequireRootedSaveAsPath An optional read/write boolean value. true if the filename parameter in a SaveAs method must be an absolute path; otherwise, false. The default is true.

The [!INCLUDEvstecasp] process must have permission to create files in the specified location. Note: This property is new in the [!INCLUDEdnprdnlong].
SectionInformation (Inherited from ConfigurationSection.)
SendCacheControlHeader An optional read/write boolean value. true if a cache control header that is set to Private is sent by default; otherwise, false. If true, client-side caching is disabled. The default is true. Note: This property is new in the [!INCLUDEdnprdnlong].
ShutdownTimeout An optional read/write datetime value that specifies the time that is allowed for a worker process to shut down. The default is 1 minute, 30 seconds.

When the time-out expires, [!INCLUDEvstecasp] shuts down the worker process. Note: This property is new in the [!INCLUDEdnprdnlong].
UseFullyQualifiedRedirectUrl An optional read/write boolean value. true if client-side redirects are fully qualified; otherwise, false. The default is false.

To fully qualify client-side redirects, use the format http://server/path. This format is required for some mobile controls. If true, all redirects that are not fully qualified are automatically converted to a fully qualified format. If false, relative redirects are sent to the client. Note: If false, some browsers might encounter issues when loading pages that are in cookieless sessions.
WaitChangeNotification An optional read/write sint32 value that specifies the time, in seconds, to wait for another file change notification before the application domain restarts. The default is 0.

Set this attribute to a number that is greater than the time between the updates of two file copy change notifications. File change notifications are combined based on the value of this property and the MaxWaitChangeNotification property. Note: This property is new in the [!INCLUDEdnprdnlong].

Subclasses

This class contains no subclasses.

Inheritance Hierarchy

ConfigurationSection

HttpRuntimeSection

Requirements

Type Description
Client - [!INCLUDEiis70] on [!INCLUDEwinvista]
- [!INCLUDEiis75] on [!INCLUDEwin7]
- [!INCLUDEiis80] on [!INCLUDEwin8]
- [!INCLUDEiis100] on [!INCLUDEwin10]
Server - [!INCLUDEiis70] on [!INCLUDEwinsrv2008]
- [!INCLUDEiis75] on [!INCLUDEwinsrv2008r2]
- [!INCLUDEiis80] on [!INCLUDEwinsrv2012]
- [!INCLUDEiis85] on [!INCLUDEwinsrv2012r2]
- [!INCLUDEiis100] on [!INCLUDEwinsrv2016]
Product - [!INCLUDEiis70], [!INCLUDEiis75], [!INCLUDEiis80], [!INCLUDEiis85], [!INCLUDEiis100]
MOF file WebAdministration.mof

See Also

System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
ConfigurationSection Class
CompilationSection Class
CIM_DATETIME