Compartilhar via


IHttpStoredContext Interface

Define informações de contexto para dados armazenados.

Sintaxe

class IHttpStoredContext  

Métodos

A tabela a seguir lista os métodos expostos pela classe IHttpStoredContext.

Nome Descrição
CleanupStoredContext Limpa o contexto armazenado.

Classes Derivadas

Nome Descrição
IWebSocketContext Representa o suporte de contexto para comunicações WebSocket bidirecionais em um único soquete TCP.

Comentários

Muitas classes do IIS 7 mantêm um private ponteiro IDispensedHttpModuleContextContainer como uma variável de membro. Essas classes implementam várias interfaces, incluindo IHttpApplication, IHttpConnection, IHttpContext, IHttpFileInfo, IHttpSite, IHttpUrlInfo e IMetadataInfo.

Cada uma dessas interfaces define um GetModuleContextContainer método, que não aceita argumentos e retorna um ponteiro IHttpModuleContextContainer . Quando os vários GetModuleContextContainer métodos são chamados, a maioria desses implementadores retorna os private dados como um upcast IHttpModuleContextContainer. Isso permite que os implementadores de interface exponham contêineres personalizados, mantendo o tempo de vida desses contêineres.

Você pode definir classes personalizadas que implementam a IHttpStoredContext interface e, em seguida, criar um ponteiro para esse IHttpStoredContext implementador de classe chamando o new operador. Em seguida, você pode adicionar e recuperar esse ponteiro em um IHttpModuleContextContainer ponteiro chamando os métodos IHttpModuleContextContainer::SetModuleContext e IHttpModuleContextContainer::GetModuleContext , respectivamente.

Quando o IHttpStoredContext ponteiro não é mais necessário, o CleanupStoredContext método é chamado internamente, onde o implementador do IHttpStoredContext método de interface geralmente deve chamar delete``this.

Cuidado

Embora possa ser uma operação segura fazer downcast de um IHttpModuleContextContainer para um IDispensedHttpModuleContextContainer usando o operador dynamic_cast , você deve evitar executar essa conversão. A IDispensedHttpModuleContextContainer interface adiciona apenas um método, ReleaseContainer, à sua interface base, e esse método deve ser chamado apenas internamente.

Requisitos

Tipo Descrição
Cliente – IIS 7.0 no Windows Vista
– IIS 7.5 no Windows 7
– IIS 8.0 no Windows 8
– IIS 10.0 no Windows 10
Servidor – IIS 7.0 no Windows Server 2008
– IIS 7.5 no Windows Server 2008 R2
– IIS 8.0 no Windows Server 2012
– IIS 8.5 no Windows Server 2012 R2
– IIS 10.0 no Windows Server 2016
Product – 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
Cabeçalho Httpserv.h

Confira também

Interfaces principais do servidor Web