Share via


hostingEnvironment 元素(ASP.NET 设置架构)

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

定义用来控制应用程序宿主环境的行为的配置设置。

<hostingEnvironment 
    idleTimeout="HH:MM:SS" 
    shadowCopyBinAssemblies="true|false" 
    shutdownTimeout="number"
    urlMetadataSlidingExpiration="HH:MM:SS"
/>

特性和元素

以下几节描述了特性、子元素和父元素。

特性

特性

说明

idleTimeout

可选的 TimeSpan 特性。

卸载不活动的应用程序前设置时间值,格式为HH:MM:SS 或“不限”。 默认值为“Infinite”。

shadowCopyBinAssemblies

可选的 Boolean 特性。

设置一个布尔值,该值指示 Bin 目录中的应用程序的程序集是否影像复制到该应用程序的 ASP.NET 临时文件目录中。

默认值为 true。

shutdownTimeout

可选的 TimeSpan 特性。

设置正常关闭应用程序的时间量(以秒为单位)。 有关更多信息,请参见 ShutdownTimeout

默认值为 30。

urlMetadataSlidingExpiration

可选的 TimeSpan 特性。

确定 ASP.NET 如何缓存 URL 的元数据。 格式为 HH:MM:SS 或“不限”。 值“00:00:00”与“不限”具有特殊含义。 有关更多信息,请参见 UrlMetadataSlidingExpiration

默认值为 1 分钟。

子元素

无。

父元素

元素

说明

configuration

公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素。 包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。

备注

默认配置

下面的默认 hostingEnvironment 元素不是在计算机配置文件或根 Web.config 文件中显式配置的,而是由 .NET Framework 版本 2.0 中的应用程序返回的默认配置。

备注

系统将值“Infinite”定义为 MaxValue

<hostingEnvironment 
    idleTimeout="Infinite" 
    shutdownTimeout="30" 
    shadowCopyBinAssemblies="true" />

示例

下例演示如何控制应用程序承载环境的行为。

<system.web>
    <hostingEnvironment idleTimeout="20"
    shutdownTimeout="30"/>
</system.web>

元素信息

配置节处理程序

System.Web.Configuration.HostingEnvironmentSection

配置成员

SystemWebSectionGroup.HostingEnvironment

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

要求

IIS 6.0

.NET Framework 2.0

Visual Studio 2005

请参见

任务

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

参考

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

System.Web.Hosting.HostingEnvironment

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API