hostingEnvironment 要素 (ASP.NET 設定スキーマ)

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

アプリケーションのホスト環境の動作を制御する構成設定を定義します。

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

Description

idleTimeout

省略可能な TimeSpan 型の属性です。

アクティブでないアプリケーションをアンロードするまでの時間を HH:MM:SS または "Infinite" の形式で設定します。 既定値は "Infinite" です。

shadowCopyBinAssemblies

省略可能な Boolean 型の属性です。

Bin ディレクトリにあるアプリケーションのアセンブリが、アプリケーションの ASP.NET Temporary Files ディレクトリにシャドウ コピーされるかどうかを示す Boolean 型の値を設定します。

既定値は true です。

shutdownTimeout

省略可能な TimeSpan 型の属性です。

アプリケーションを適切に終了するまでの時間を分単位で設定します。 詳細については、「ShutdownTimeout」を参照してください。

既定値は 30 です。

urlMetadataSlidingExpiration

省略可能な TimeSpan 型の属性です。

ASP.NET によって URL メタデータをキャッシュする方法を決定します。 形式は HH:MM:SS または "Infinite" です。 値 "00:00:00" および "Infinite" は特別な意味を持ちます。 詳細については、「UrlMetadataSlidingExpiration」を参照してください。

既定値は 1 分です。

子要素

なし。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。

system.web

構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。

解説

既定の構成

次の既定の hostingEnvironment 要素は、マシン構成ファイルやルートの Web.config ファイルでは明示的に構成されませんが、.NET Framework Version 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

Reference

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