IHttpStoredContext 接口

定义存储数据的上下文信息。

语法

class IHttpStoredContext  

方法

下表列出了 IHttpStoredContext 类公开的方法。

名称 描述
CleanupStoredContext 清理存储的上下文。

派生类

名称 描述
IWebSocketContext 表示通过单个 TCP 套接字对双向 WebSocket 通信的上下文支持。

注解

许多 IIS 7 类作为成员变量维护 IDispensedHttpModuleContextContainer private 指针。 这些类实现各种接口,包括 IHttpApplication、IHttpConnectionIHttpContextIHttpFileInfoIHttpSiteIHttpUrlInfoIMetadataInfo

每个接口都定义了一个 GetModuleContextContainer 方法,该方法不接受任何参数,并返回 IHttpModuleContextContainer 指针。 调用各种GetModuleContextContainer方法时,其中大多数实现者将数据作为向上转换IHttpModuleContextContainer返回private。 这样,接口实现者就可以公开自定义容器,同时保持这些容器的生存期。

可以定义实现接口的IHttpStoredContext自定义类,然后通过调用new运算符创建指向此类IHttpStoredContext实现者的指针。 然后,可以通过分别调用 IHttpModuleContextContext::SetModuleContext 和 IHttpModuleContextContainer::GetModuleContext 方法,在指针上IHttpModuleContextContainer添加和检索此指针。

不再需要指针 IHttpStoredContext 时,该方法 CleanupStoredContext 在内部调用,其中接口方法的 IHttpStoredContext 实现者通常应调用 delete``this

注意

虽然这可能是使用 dynamic_cast 运算符向下转换到某个IHttpModuleContextContainerIDispensedHttpModuleContextContainer安全操作,但应避免执行此强制转换。 该 IDispensedHttpModuleContextContainer 接口只将一个方法 ReleaseContainer 添加到其基接口,并且此方法只能在内部调用。

要求

类型 描述
客户端 - IIS 7.0(在 Windows Vista 上)
- IIS 7.5(在 Windows 7 上)
- IIS 8.0(在 Windows 8 上)
- IIS 10.0(在 Windows 10 上)
服务器 - IIS 7.0(在 Windows Server 2008 上)
- IIS 7.5(在 Windows Server 2008 R2 上)
- IIS 8.0(在 Windows Server 2012 上)
- IIS 8.5(在 Windows Server 2012 R2 上)
- IIS 10.0(在 Windows Server 2016 上)
产品 - 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 服务器核心接口