HttpRuntimeSection クラス

特定の ASP.NET アプリケーションに対する要求の処理方法を決定する、ASP.NET HTTP ランタイム設定を構成します。

構文

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 アプリケーションに対して ASP.NET がキューに入れる要求の最大数を指定する、オプションの読み取り/書き込みの sint32 値。 既定値は 5000 です。 注: .NET Framework バージョン 1.0 および 1.1 の場合、既定値は 100 です。

ある要求を処理するために十分な空きスレッドがない場合、その要求はキューに入れられます。 キュー内の要求の数がこのプロパティで指定されている上限を超える場合、受信した要求は "503 - Server Too Busy" というエラーで拒否されます。
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 ASP.NET によって自動的に停止されるまでに要求を実行できる最長時間を指定する、オプションの読み取り/書き込みの datetime 値。 既定値は 1 分 50 秒です。

このタイムアウトは、CompilationSection クラスの Debug プロパティが false の場合にのみ適用されます。 デバッグ中にアプリケーションがシャットダウンされないようにするため、このタイムアウトを大きな値に設定しないでください。
Location (ConfigurationSection から継承。)キー プロパティ。
MaxRequestLength 入力ストリームのバッファリングしきい値の上限 (キロバイト単位) を指定する、オプションの読み取り/書き込みの sint32 値。 既定値は 4096 (4 MB) です。

この上限を使うと、たとえば大きなファイルをサーバーに投稿するユーザーによって引き起こされるサービス拒否攻撃を防ぐことができます。
MaxWaitChangeNotification 最初のファイル変更通知の後、新しい要求に対してアプリケーション ドメインが再起動するまでに待機する最長時間 (秒単位) を指定する、オプションの読み取り/書き込みの sint32 値。 既定値は 0 です。

このプロパティは、ファイルのコピー プロセスが完了するまでの時間よりも長い数値に設定してください。 ファイル変更通知は、このプロパティと WaitChangeNotification プロパティの値に基づいて組み合わされます。 注意: このプロパティは、.NET Framework 2.0 で新しく追加されました。
MinFreeThreads 処理を完了するために追加のスレッドが必要となる要求のために ASP.NET が確保しておくスレッドの最小数を指定する、オプションの読み取り/書き込みの sint32 値。 既定値は 8 です。
MinLocalRequestFreeThreads 処理を完了するために追加のスレッドが必要となるローカル要求のために ASP.NET が確保しておくスレッドの最小数を指定する、オプションの読み取り/書き込みの sint32 値。 既定値は 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。それ以外の場合は falsetrue の場合、クライアント側のキャッシュは無効になります。 既定値は、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 です。

この属性は、2 つのファイル コピー変更通知の更新間隔より大きい数値に設定します。 ファイル変更通知は、このプロパティと 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
Product - 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