IHttpStoredContext 接口
定义存储数据的上下文信息。
语法
class IHttpStoredContext
方法
下表列出了 IHttpStoredContext
类公开的方法。
名称 | 描述 |
---|---|
CleanupStoredContext | 清理存储的上下文。 |
派生类
名称 | 描述 |
---|---|
IWebSocketContext | 表示通过单个 TCP 套接字对双向 WebSocket 通信的上下文支持。 |
注解
许多 IIS 7 类作为成员变量维护 IDispensedHttpModuleContextContainer private
指针。 这些类实现各种接口,包括 IHttpApplication、IHttpConnection、IHttpContext、IHttpFileInfo、IHttpSite、IHttpUrlInfo 和 IMetadataInfo。
每个接口都定义了一个 GetModuleContextContainer
方法,该方法不接受任何参数,并返回 IHttpModuleContextContainer 指针。 调用各种GetModuleContextContainer
方法时,其中大多数实现者将数据作为向上转换IHttpModuleContextContainer
返回private
。 这样,接口实现者就可以公开自定义容器,同时保持这些容器的生存期。
可以定义实现接口的IHttpStoredContext
自定义类,然后通过调用new
运算符创建指向此类IHttpStoredContext
实现者的指针。 然后,可以通过分别调用 IHttpModuleContextContext::SetModuleContext 和 IHttpModuleContextContainer::GetModuleContext 方法,在指针上IHttpModuleContextContainer
添加和检索此指针。
不再需要指针 IHttpStoredContext
时,该方法 CleanupStoredContext
在内部调用,其中接口方法的 IHttpStoredContext
实现者通常应调用 delete``this
。
注意
虽然这可能是使用 dynamic_cast 运算符向下转换到某个IHttpModuleContextContainer
IDispensedHttpModuleContextContainer
安全操作,但应避免执行此强制转换。 该 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 |