HttpRuntimeSection 类

配置 ASP.NET HTTP 运行时设置，以确定如何处理给定 ASP.NET 应用程序的请求。

语法

class HttpRuntimeSection : ConfigurationSection  

方法

下表列出了 HttpRuntimeSection 类公开的方法。

名称	描述
GetAllowDefinition	（继承自 ConfigurationSection。）
GetAllowLocation	（从 ConfigurationSection 继承。）
RevertToParent	（从 ConfigurationSection 继承。）
SetAllowDefinition	（从 ConfigurationSection 继承。）
SetAllowLocation	（从 ConfigurationSection 继承。）

属性

下表列出了 HttpRuntimeSection 类公开的属性。

名称	描述
ApartmentThreading	一个可选的读/写 boolean 值。 如果启用了单元线程处理以兼容经典 ASP，则为 true；否则为 false。 默认为 false。 注意：此属性是 .NET Framework 2.0 中的新属性。
AppRequestQueueLimit	一个可选的读/写 sint32 值，指定 ASP.NET 应用程序队列的最大请求数。 默认值为 5000。 注意：对于 .NET Framework 版本 1.0 和 1.1，默认值为 100。 如果没有足够的可用线程来处理请求，则请求将排队。 当队列中的请求数超过此属性中指定的限制时，传入请求将被拒绝，并出现错误“503 - 服务器太忙”。
DelayNotificationTimeout	一个可选的读/写 datetime 值，指定延迟通知的超时。 默认值为 5 秒。 注意：此属性是 .NET Framework 2.0 中的新属性。
Enable	一个可选的读/写 boolean 值。 如果启用了应用程序域 (AppDomain) 以接受当前和子节点级别的传入请求，则为 true；否则为 false。 默认为 true。 如果为 false，则应用程序实际上已关闭。
EnableHeaderChecking	一个可选的读/写 boolean 值。 如果 ASP.NET 应检查请求标头是否存在潜在的注入攻击，则为 true ；否则为 false。 默认为 true。 如果检测到攻击，则 ASP.NET 会以错误响应。 注意：此属性是 .NET Framework 2.0 中的新属性。
EnableKernelOutputCache	一个可选的读/写 boolean 值。 如果已启用输出缓存，则为 true；否则为 false。 默认为 true。 仅当安装了 IIS 6.0 或 7.0 时，此属性才相关。 输出缓存配置和请求类型确定是否可以缓存内容。 要缓存响应，必须确保满足以下条件： - 缓存必须由页面指令或使用缓存 API 显式启用。 - 缓存必须具有过期策略，以便内核识别何时放弃响应。 - 缓存没有任何变量标头或参数。 - 不需要身份验证。
EnableVersionHeader	一个可选的读/写 boolean 值。 如果 ASP.NET 应输出版本标头，则为 true；否则为 false。 默认为 true。 Visual Studio 2005 使用此属性来确定正在使用哪个版本的 ASP.NET。 对于生产站点，此属性不是必需的，可以禁用。
ExecutionTimeout	可选的读/写 datetime 值，指定允许执行请求的最长时间，超过此时间后，ASP.NET 会自动停止请求。 默认值为 1 分 50 秒。 仅当 CompilationSection 类中的 Debug 属性为 false 时，此超时才适用。 为了避免在调试时关闭应用程序，请不要将此超时设置为大值。
Location	（继承自 ConfigurationSection。）一个键属性。
MaxRequestLength	一个可选的读/写 sint32 值，指定输入流缓冲阈值的限制（以 KB 为单位）。 默认值为 4096 (4 MB)。 可以使用此限制来防止某种形式的拒绝服务攻击，例如，用户将大型文件发布到服务器。
MaxWaitChangeNotification	一个可选的读/写 sint32 值，指定等待第一个文件更改通知的最长时间（以秒为单位），超过此时间后，应用程序域将重启以处理新请求。 默认值为 0。 将此属性设置为大于完成任何文件复制进程的时长的数字。 文件更改通知基于此属性和 WaitChangeNotification 属性的值进行组合。 注意：此属性是 .NET Framework 2.0 中的新属性。
MinFreeThreads	一个可选的读/写 sint32 值，指定 ASP.NET 针对需要额外线程才能完成处理的请求所保留的最小线程数。 默认值为 8。
MinLocalRequestFreeThreads	一个可选的读/写 sint32 值，指定 ASP.NET 针对需要额外线程才能完成处理的本地请求所保留的最小线程数。 默认值为 4。 注意：指定的线程数是为来自本地主机的请求保留的，以防其中一些请求在处理过程中发出子请求。 这有助于防止递归重新进入 Web 服务器时可能出现死锁的情况。
Path	（继承自 ConfigurationSection。）一个键属性。
RequestLengthDiskThreshold	一个可选的读/写 sint32 值，指定输入流缓冲阈值的限制（以字节为单位）。 默认值为 256。 此值不应超过属性中的 MaxRequestLength 值。 注意：此属性是 .NET Framework 2.0 中的新属性。
RequireRootedSaveAsPath	一个可选的读/写 boolean 值。 如果 SaveAs 法中的 filename必须是绝对路径，则为 true；否则为 false。 默认为 true。 ASP.NET 进程必须具有在指定位置创建文件的权限。 注意：此属性是 .NET Framework 2.0 中的新属性。
SectionInformation	（从 ConfigurationSection 继承。）
SendCacheControlHeader	一个可选的读/写 boolean 值。 如果默认发送设置为“Private”的缓存控件标头，则为 true；否则为 false。 如果为 true，则禁用客户端缓存。 默认为 true。 注意：此属性是 .NET Framework 2.0 中的新属性。
ShutdownTimeout	可选读/写 datetime 值，指定允许工作进程关闭的时间长度。 默认值为 1 分 30 秒。 超时到期后，ASP.NET 将关闭工作进程。 注意：此属性是 .NET Framework 2.0 中的新属性。
UseFullyQualifiedRedirectUrl	一个可选的读/写 boolean 值。 如果完全限定客户端重定向，则为 true；否则为 false。 默认为 false。 若要完全限定客户端重定向，请使用 http://server/path 格式。 某些移动控件需要此格式。 如果为 true，则未完全限定的所有重定向将自动转换为完全限定的格式。 如果为 false，则会将相对重定向发送到客户端。 注意：如果为 false，某些浏览器在加载无 Cookie 会话中的页面时可能会遇到问题。
WaitChangeNotification	一个可选的读/写 sint32 值，该值指定等待另一个文件更改通知的时间（以秒为单位），超过此时间后，应用程序域将重启。 默认值为 0。 将此属性设置为大于两个文件复制更改通知更新之间的时间的数字。 文件更改通知基于此属性和 MaxWaitChangeNotification 属性的值进行组合。 注意：此属性是 .NET Framework 2.0 中的新属性。

子类

此类不包含子类。

继承层次结构

ConfigurationSection

HttpRuntimeSection

要求

类型	描述
客户端	- Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10 上的 IIS 10.0
服务器	- Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016 上的 IIS 10.0
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

System.Web.Configuration.SystemWebSectionGroup.HttpRuntime
ConfigurationSection 类
CompilationSection 类
CIM_DATETIME