共用方式為


IHttpCoNtext 介面

定義 物件,表示要求層級作業的處理內容。

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 模組時使用的其他介面。

例如, GetRequestGetResponse 方法會分別擷取目前內容的 IHttpRequestIHttpResponse 介面。 這些介面可讓開發人員存取或修改要求本文和回應主體、HTTP 標頭、伺服器行為等等。

IIS 7 可讓您使用 CloneContextExecuteRequestReleaseClonedContext 方法,透過 IHttpContext 介面建立和執行子內容。 IIS 也提供 GetParentContextGetRootContext 方法來協助開發人員撰寫 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

另請參閱

Web Server Core 介面