Export (0) Print
Expand All
Expand Minimize
0 out of 1 rated this helpful - Rate this topic

HttpRuntimeSection Class [IIS 7 and higher]

IIS 7.0

Configures ASP.NET HTTP run-time settings that determine how a request is processed for a given ASP.NET 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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
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.

NoteNote:
This property is new in the .NET Framework 2.0.

This class contains no subclasses.

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.