HttpRuntimeSection Class [IIS 7 and higher]
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 |
|---|---|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSection.) |
|
(Inherited from ConfigurationSection.) |
|
(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. .gif "Note") 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:
|
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 https://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
HttpRuntimeSection
Requirements
Type |
Description |
|---|---|
Client |
Requires IIS 7 on Windows Vista. |
Server |
Requires IIS 7 on Windows Server 2008. |
Product |
IIS 7 |
MOF file |
WebAdministration.mof |
See Also
Reference
SystemWebSectionGroupHttpRuntime()()()()
ConfigurationSection Class [IIS 7 and higher]
CompilationSection Class [IIS 7 and higher]