IHttpStoredContext 介面
定義預存數據的內容資訊。
語法
class IHttpStoredContext
方法
下表列出 類別所 IHttpStoredContext
公開的方法。
名稱 | 描述 |
---|---|
CleanupStoredContext | 清除預存內容。 |
衍生類別
名稱 | 描述 |
---|---|
IWebSocketContext | 表示透過單一 TCP 套接字進行雙向 WebSocket 通訊的內容支援。 |
備註
許多 IIS 7 類別會維護 private
IDispensedHttpModuleContextContainer 指標做為成員變數。 這些類別會實作各種介面,包括 IHttpApplication、IHttpConnection、IHttpContext、IHttpFileInfo、IHttpSite、IHttpUrlInfo 和 IMetadataInfo。
每個介面都會 GetModuleContextContainer
定義方法,該方法不接受任何自變數,並傳回 IHttpModuleContextContainer 指標。 呼叫各種 GetModuleContextContainer
方法時,大部分的實作者都會 private
以向上轉換 IHttpModuleContextContainer
的形式傳回數據。 這可讓介面實作者公開自定義容器,同時維護這些容器的存留期。
您可以定義實作 介面的IHttpStoredContext
自定義類別,然後呼叫 new
運算符來建立這個IHttpStoredContext
類別實作者的指標。 接著,您可以分別呼叫 IHttpModuleContextContainer::SetModuleContext 和 IHttpModuleContextContainer::GetModuleContext 方法,在指標上IHttpModuleContextContainer
新增和擷取此指標。
IHttpStoredContext
不再需要指標時,CleanupStoredContext
會在內部呼叫 方法,其中介面方法的IHttpStoredContext
實作者通常應該呼叫 delete``this
。
警告
雖然使用 dynamic_cast 運算符將 向下轉型IHttpModuleContextContainer
為 IDispensedHttpModuleContextContainer
的安全作業,但您應該避免執行此轉換。 介面IDispensedHttpModuleContextContainer
只會將一個 ReleaseContainer 方法新增至其基底介面,而且這個方法應該只在內部呼叫。
需求
類型 | 描述 |
---|---|
用戶端 | - 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 |
Products | - 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 |