ServerRuntimeSection Class

Article
05/19/2022

Configures request limits for applications on a Web server.

Syntax

class ServerRuntimeSection : ConfigurationSection

Methods

The following table lists the methods exposed by the ServerRuntimeSection 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 ServerRuntimeSection class.

Name	Description
`AlternateHostName`	A read/write `string` value that specifies the name of an alternate host.
`AppConcurrentRequestLimit`	A read/write `uint32` value that specifies the maximum number of requests that can be queued for an application. The default is 5000.
`Enabled`	A read/write `boolean` value. `true` if applications on the Web server are allowed to serve content; otherwise, `false`. The default is `true`.
`EnableNagling`	A read/write `boolean` value. `true` if nagling is enabled; otherwise, `false`. The default is `false`. Note: Nagling is an optimization for HTTP over TCP that increases efficiency by trying to minimize the number of packets needed to send data. It works by waiting to send a packet until its data area is full, until a 200-millisecond time-out period expires, or until the sender indicates that it is done sending data. IIS versions 5.1 and earlier use nagling for all data sent to the client. Nagling has a possible downside. If an extension does not fill up the packet, there is still a delay of 200 milliseconds before the response is sent. This behavior is most evident for ISAPI extensions that support an HTTP `Keep-Alive` header in the response to the client. In this case, IIS does not close the connection after the response, so the final packet ends up waiting for the 200 milliseconds.
`FrequentHitThreshold`	A read/write `uint32` value that specifies the number of times a URL must be requested, within the time span specified in the `FrequentHitTimePeriod` property, to be considered frequently hit. The value must be between 1 and 2147483647. The default is 2. If the URL is frequently hit, it is cached by IIS.
`FrequentHitTimePeriod`	A read/write `datetime` value that specifies the time interval in which a URL must be requested a specified number of times to be considered frequently hit. The default is 10 seconds. The number of times is specified in the `FrequentHitThreshold` property.
`Location`	(Inherited from `ConfigurationSection`.) A key property.
`MaxRequestEntityAllowed`	A read/write `uint32` value that specifies the maximum number of bytes allowed in the entity body of a request. If a `Content-Length` header specifies a larger amount, IIS sends a 403 error response. Note: Although the IIS_Schema.xml file specifies 4294967295 (unlimited) as the default for this property, the default returned by the WMI provider is -1.
`Path`	(Inherited from `ConfigurationSection`.) A key property.
`SectionInformation`	(Inherited from `ConfigurationSection`.)
`UploadReadAheadSize`	A read/write `uint32` value that specifies the number of bytes a Web server will read into a buffer and pass to an ISAPI extension. This occurs once per client request. The ISAPI extension receives any additional data directly from the client. The value must be between 0 and 2147483647. The default is 49152.

Subclasses

This class contains no subclasses.

Remarks

This class corresponds to the <serverRuntime> section in the ApplicationHost.config file.

Inheritance Hierarchy

ConfigurationSection

ServerRuntimeSection

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