IHttpContext インターフェイス
要求レベルの操作の処理コンテキストを表す オブジェクトを定義します。
構文
class IHttpContext
メソッド
次の表に、 クラスによって公開されるメソッドの一覧を IHttpContext 示します。
| 名前 | 説明 |
|---|---|
| AllocateRequestMemory | 指定した量のメモリを割り当てます。 |
| CancelIo | 保留中の送受信操作を取り消します。 |
| CloneContext | 現在の要求コンテキストの複製を作成します。 |
| DisableNotifications | 現在のモジュールでこの要求に対して保留中の特定の通知を無効にします。 |
| ExecuteRequest | 子要求を実行します。 |
| GetApplication | 現在のコンテキストのアプリケーション コンテナーを取得します。 |
| Getconnection | 現在のコンテキストの接続コンテナーを取得します。 |
| GetCurrentExecutionStats | 現在のコンテキストの実行統計を取得します。 |
| GetExecuteFlags | 現在のコンテキストの実行フラグを取得します。 |
| GetFileInfo | 現在のコンテキストのファイル情報コンテナーを取得します。 |
| GetIsLastNotification | 現在のモジュール ホスト内で、この要求に対してさらに多くの通知が保留されているかどうかを示します。 |
| GetMetadata | 現在の要求コンテキストのメタデータ コンテナーを取得します。 |
| GetModuleContextContainer | 現在のコンテキストのモジュール コンテキスト コンテナーを取得します。 |
| GetNextNotification | 現在のモジュール ホストの次の通知を取得します。 |
| GetParentContext | 現在のコンテキストの親コンテキストへのポインターを取得します。 |
| GetPhysicalPath | 現在の要求の物理パスを取得します。 |
| GetRequest | 現在のコンテキストの HTTP 要求コンテナーを返します。 |
| Getresponse | 現在のコンテキストの HTTP 応答コンテナーを返します。 |
| GetResponseHeadersSent | HTTP 応答ヘッダーがクライアントに送信されたかどうかを判断します。 |
| GetRootContext | 現在のコンテキストのルート コンテキストへのポインターを取得します。 |
| GetScriptMap | 現在のコンテキストのスクリプト マップ コンテナーを取得します。 |
| GetScriptName | 現在の要求の URL を取得します。 |
| GetScriptTranslated | 現在の要求の物理パスを取得します。 |
| GetServerVarChanges | 現在のコンテキストのサーバー変数への変更を取得します。 |
| GetServerVariable | 特定のサーバー変数を取得します。 |
| GetSite | 現在のコンテキストのサイト情報コンテナーを取得します。 |
| GetTraceContext | 現在のコンテキストのトレース コンテキスト コンテナーを取得します。 |
| GetUrlInfo | 現在のコンテキストの URL 情報コンテナーを取得します。 |
| GetUser | 現在のコンテキストのユーザー情報コンテナーを取得します。 |
| IndicateCompletion | 非同期作業の完了を示し、呼び出し元スレッドでの実行の再開を IIS に要求します。 |
| MapHandler | サイト上の GIVE URL、HTTP 動詞ペアのハンドラーをマップします。 |
| Mappath | 相対 URL の物理パスを返します。 |
| NotifyCustomNotification | カスタム要求レベルの通知を生成します。 |
| PostCompletion | 非同期作業の完了を示し、IIS にスレッド プールへのキュー実行を要求します。 |
| ReleaseClonedContext | 複製された IHttpContext インスタンスを解放します。 |
| SetRequestHandled | 現在の要求のハンドラーが完了したことを示します。 |
| SetServerVariable | サーバー変数を指定した値に設定します。 |
派生クラス
| 名前 | 説明 |
|---|---|
| IHttpContext2 | HTTP 要求の再処理を表し、非同期操作中に元のユーザーに関する情報を取得できるようにします。 |
| IHttpContext3 | HTTP 要求の再処理を表し、非同期操作の追加サポートを有効にします。 |
| IHttpContext4 | HTTP 要求の再処理を表し、診断操作の追加サポートを有効にします。 |
解説
インターフェイスはIHttpContext、現在の要求レベルのコンテキストに関する情報にアクセスするための HTTP モジュールのプログラムインターフェイスメインを表します。 このインターフェイスは、HTTP モジュールの作成時に使用できる追加のインターフェイスをいくつか取得します。
たとえば、 GetRequest メソッドと GetResponse メソッドはそれぞれ、現在のコンテキストの IHttpRequest インターフェイスと IHttpResponse インターフェイスを取得します。 これらのインターフェイスを使用すると、開発者は要求本文と応答本文、HTTP ヘッダー、サーバーの動作などをアクセスまたは変更できます。
IIS 7 では、および メソッドを使用して、インターフェイスをIHttpContext介して子コンテキストをCloneContextExecuteRequest作成およびReleaseClonedContext実行できます。 IIS には、 メソッドと メソッドも用意 GetParentContext されています GetRootContext 。これは、現在のコンテキストがルート、子、または親のどちらのコンテキストであるかに応じて動作を変更できる HTTP モジュールを開発者が記述するのに役立ちます。
IHttpContext には、開発者が通知の動作を制御するのに役立ついくつかのメソッドも用意されています。 たとえば、 メソッドを DisableNotifications 使用して通知を無効にしたり、 メソッドを GetIsLastNotification 使用して、残りの通知があるかどうかを判断したりすることができます。 さらに、 メソッドを GetNextNotification 使用して通知をマージしたり、 メソッドを NotifyCustomNotification 使用してカスタム通知を生成したりすることができます。
要件
| Type | 説明 |
|---|---|
| Client | - 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.0 - Windows Server 2016上の IIS 10.0 |
| 製品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 - IIS Express 7.5、IIS Express 8.0、IIS Express 10.0 |
| Header | Httpserv.h |