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 |
Configures [!INCLUDEvstecasp] HTTP run-time settings that determine how a request is processed for a given [!INCLUDEvstecasp] application.
class HttpRuntimeSection : ConfigurationSection
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 .) |
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]. |
This class contains no subclasses.
HttpRuntimeSection
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 |
System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
ConfigurationSection Class
CompilationSection Class
CIM_DATETIME