HttpRuntimeSection Class

Article
05/20/2022

Configures ASP.NET HTTP run-time settings that determine how a request is processed for a given ASP.NET 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 .NET Framework 2.0.
`AppRequestQueueLimit`	An optional read/write `sint32` value that specifies the maximum number of requests that ASP.NET queues for the application. The default is 5000. Note: For the .NET Framework 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 .NET Framework 2.0.
`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 ASP.NET should check the request header for potential injection attacks; otherwise, `false`. The default is `true`. If an attack is detected, ASP.NET responds with an error. Note: This property is new in the .NET Framework 2.0.
`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 ASP.NET should output a version header; otherwise, `false`. The default is `true`. Visual Studio 2005 uses this property to determine which version of ASP.NET 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 ASP.NET 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 .NET Framework 2.0.
`MinFreeThreads`	An optional read/write `sint32` value that specifies the minimum number of threads that ASP.NET 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 ASP.NET 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 .NET Framework 2.0.
`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 ASP.NET process must have permission to create files in the specified location. Note: This property is new in the .NET Framework 2.0.
`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 .NET Framework 2.0.
`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, ASP.NET shuts down the worker process. Note: This property is new in the .NET Framework 2.0.
`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 .NET Framework 2.0.

Subclasses

This class contains no subclasses.

Inheritance Hierarchy

ConfigurationSection

HttpRuntimeSection

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016
Product	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF file	WebAdministration.mof