定義 物件,表示要求層級作業的處理內容。
Syntax
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 | 對應網站中指定 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 可讓您使用 CloneContext 、 ExecuteRequest 和 ReleaseClonedContext 方法,透過 IHttpContext 介面建立和執行子內容。 IIS 也提供 GetParentContext 和 GetRootContext 方法來協助開發人員撰寫 HTTP 模組,根據目前內容是根、子內容或父內容,變更行為。
IHttpContext 也提供數種方法來協助開發人員控制通知的行為。 例如,您可以使用 DisableNotifications 方法來停用通知或 GetIsLastNotification 方法來判斷是否有任何剩餘的通知。 此外,您可以使用 GetNextNotification 方法來合併通知或 NotifyCustomNotification 方法來引發自訂通知。
規格需求
| 類型 | 描述 |
|---|---|
| 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 |
| 標頭 | Httpserv.h |