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

<httpRuntime>

低帯域幅での表示をオンにする

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

.NET Framework 一般リファレンス

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

ASP.NET アプリケーションの要求の処理方法を決定する ASP.NET HTTP 実行時設定を構成します。

configuration 要素 (全般設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
httpRuntime 要素 (ASP.NET 設定スキーマ)

<httpRuntime
   executionTimeout = "HH:MM:SS" 
   maxRequestLength = "number" 
   requestLengthDiskThreshold = "number" 
   useFullyQualifiedRedirectUrl = "[True|False]" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   appRequestQueueLimit = "number"
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   apartmentThreading = "[True|False]"
   requireRootedSaveAsPath = "[True|False]"
   enable = "[True|False]" 
   sendCacheControlHeader = "[True|False]" 
   shutdownTimeout = "HH:MM:SS"
   delayNotificationTimeout = "HH:MM:SS"
   waitChangeNotification = "number" 
   maxWaitChangeNotification = "number" 
   enableHeaderChecking = "[True|False]" 
/>

属性と要素

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

属性

属性説明

apartmentThreading

省略可能な Boolean 属性です。

従来の ASP との互換性を維持するため、アパートメントスレッドを有効にします。

この属性は .NET Framework Version 2.0 で新たに追加されました。既定値は False です。

appRequestQueueLimit

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

ASP.NET がアプリケーションのためにキューに置く要求の最大数を指定します。要求を処理するためのフリースレッドの数が不足している場合、要求はキューに置かれます。キューに置かれた要求の数がこの属性で指定された上限を超えると、"503 - サーバーがビジー状態です" というエラーが発行され、着信する要求が拒否されます。

既定値は 5000 です。

メモ
.NET Framework Version 1.0 および 1.1 では、既定値は 100 です。

delayNotificationTimeout

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

遅延通知のタイムアウトを指定します。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は "00:00:05" (5 秒) です。

enable

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

現在のノードおよび子ノードレベルで、着信要求を受け入れるアプリケーションドメイン (AppDomain) が有効であるかどうかを指定します。False の場合、アプリケーションは事実上無効になります。

既定値は True です。

enableHeaderChecking

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

潜在的な注入攻撃に対して、要求ヘッダーをチェックするかどうかを指定します。攻撃が検出されると、エラーが返されます。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は True です。

enableKernelOutputCache

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

出力キャッシュが有効かどうかを指定します。この属性は、Microsoft Internet Information Services (IIS) 6.0 以降がインストールされている場合だけ適用されます。出力キャッシュの構成と要求の種類によって、コンテンツをキャッシュできるかどうかが決まります。

応答をキャッシュするには、次の条件を満たす必要があります。

ページディレクティブによって、またはキャッシュ API を使用することによって、キャッシュが明示的に有効にされる。
キャッシュに有効期限ポリシーが設定され、応答を破棄する時期をカーネルが判断できる。
キャッシュには変数ヘッダーやパラメータを指定しない。
認証が不要である。

既定値は True です。

enableVersionHeader

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

バージョンヘッダーを出力するかどうかを指定します。この属性は、どのバージョンの ASP.NET が使用されているのかを判断するために Microsoft Visual Studio 2005 によって使用されます。実際に運用するサイトでは不要なため、無効にできます。

メモ
この属性は .NET Framework Version 1.0 では使用できません。

既定値は True です。

executionTimeout

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

ASP.NET によって自動的にシャットダウンされるまでに要求を実行できる最大秒数を指定します。

このタイムアウトは、compilation 要素のデバッグ属性が False の場合だけ適用されます。デバッグ中にアプリケーションがシャットダウンされないようにするために、このタイムアウトを大きい値に設定しないでください。

メモ
.NET Framework Version 1.0 および 1.1 では、既定値は 90 です。

既定値は "00:01:50" (110 秒) です。

maxRequestLength

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

入力ストリームのバッファリングしきい値の限界値を KB 単位で指定します。この限界値は、たとえば大きいファイルをサーバーにポストするユーザーなどにより引き起こされる、サービス拒否攻撃を防止するために使用できます。

既定値は、4096 (4 MB) です。

maxWaitChangeNotification

省略可能な Int32 属性です。

最初のファイル変更通知から、新しい要求に対して AppDomain を再起動するまでの最大待機時間 (秒数) を指定します。この属性は、ファイルコピープロセスを完了するために必要な時間より大きい値に設定します。ファイル変更通知は、この属性と waitChangeNotification 属性の値に基づいて結合されます。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は 0 です。

minFreeThreads

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

新しい要求を実行できるようにするフリースレッドの最小数を指定します。ASP.NET は、追加のスレッドを使用して処理を完了する必要がある要求のために、指定した数のフリースレッドを予約します。

既定値は 8 です。

minLocalRequestFreeThreads

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

新しいローカル要求を実行できるようにするために、ASP.NET で使用可能なフリースレッドの最小数を指定します。処理中にローカルホストに対して子要求が発行される場合に備えて、ローカルホストから着信する要求のために、指定した数のスレッドが予約されます。これは、Web サーバーへの再帰的な再入でデッドロックが発生するのを防ぐのに役立ちます。

既定値は 4 です。

requestLengthDiskThreshold

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

入力ストリームのバッファリングしきい値の限界値をバイト単位で指定します。この値は、maxRequestLength 属性を超えないようにします。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は 256 です。

requireRootedSaveAsPath

省略可能な Boolean 属性です。

SaveAs メソッドの filename パラメータが絶対パスでなければならないかどうかを指定します。ASP.NET プロセスには、指定した場所にファイルを作成するためのアクセス許可が必要です。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は True です。

sendCacheControlHeader

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

キャッシュコントロールヘッダー (既定で Private に設定される) を送信するかどうかを指定します。True の場合、クライアント側のキャッシュが無効になります。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は True です。

shutdownTimeout

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

ワーカープロセスがシャットダウンするまでの時間 (分の値) を指定します。タイムアウトの時間が経過すると、ASP.NET はワーカープロセスをシャットダウンします。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は "00:01:30" (90 秒) です。

useFullyQualifiedRedirectUrl

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

クライアント側のリダイレクトが絶対パス ("http://server/path" 形式、所定のモバイルコントロールで必須) であるか、または相対パスのリダイレクトがクライアントに送信されるかを指定します。True の場合、絶対パスではないすべてのリダイレクトは、自動的に絶対パス形式に変換されます。

メモ
False の場合、Cookie なしのセッションにあるページを読み込む際に、ブラウザにより問題が検出される可能性があります。

既定値は False です。

waitChangeNotification

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

AppDomain を再起動するまでの、次のファイル変更通知の最大待機時間 (秒数) を指定します。この属性は、2 つのファイルコピー変更通知の更新間隔より大きい値に設定します。ファイル変更通知は、この属性と maxWaitChangeNotification 属性の値に基づいて結合されます。

この属性は .NET Framework Version 2.0 で新たに追加されました。

既定値は、0 秒です。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。
system.web	構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。

解説

httpRuntime 要素は、ASP.NET アプリケーションに対する要求の処理方法を決定する ASP.NET HTTP ランタイム設定を構成します。.NET Framework には、ASP.NET ランタイムホストを含め、さまざまなランタイムホストが付属しています。要求を受信すると、ASP.NET はその要求を処理するプロセスにランタイムを読み込みます。ASP.NET は、Web サーバー上で実行される各 Web アプリケーション用のアプリケーションドメインも作成します。

既定の構成

次の既定の httpRuntime 要素は、Machine.config ファイルまたはルートの Web.config ファイルでは明示的に構成されません。ただし、これはアプリケーションにより返される既定の構成です。

<httpRuntime 
   executionTimeout="110"
   maxRequestLength="4096"
   requestLengthDiskThreshold="256"
   useFullyQualifiedRedirectUrl="false"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   appRequestQueueLimit="5000"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   requireRootedSaveAsPath="true"
   enable="true"
   shutdownTimeout="90"
   delayNotificationTimeout="5"
   waitChangeNotification="0"
   maxWaitChangeNotification="0"
   requestPriority="Normal"
   enableHeaderChecking="true"
   sendCacheControlHeader="true"
   apartmentThreading="false"
/>

使用例

ASP.NET アプリケーションの HTTP ランタイムパラメータを指定する方法を次のコード例に示します。

<configuration>
  <system.web>
  <httpRuntime maxRequestLength="4000"
    enable = "True"
    idleTimeOut = "15"
    requestLengthDiskThreshold="512
    useFullyQualifiedRedirectUrl="True"
    executionTimeout="45"
    versionHeader="1.1.4128"/>
  </system.web>
</configuration>

要素情報

構成セクションハンドラ	HttpRuntimeSection
構成メンバ	HttpRuntime
構成できる場所	Machine.config ルートレベルの Web.config アプリケーションレベルの Web.config 仮想ディレクトリレベルまたは物理ディレクトリレベルの Web.config
必要条件	Microsoft Internet Information Services (IIS) 5.0、5.1、または 6.0 .NET Framework Version 1.0、1.1、2.0 Microsoft Visual Studio 2003 または Visual Studio 2005

参照

タグ

: タグの追加

コミュニティコンテンツ

新しいコンテンツの追加

注釈

プロファイル (個人情報) の管理 | お問い合わせ先 | MSDN Flash ニュースレター | 日本での個人情報の取り扱い | サイトマップ

属性

子要素

親要素

処理手順

関連項目

概念

その他の技術情報