IHttpContext Interface

Define um objeto que representa o contexto de processamento para operações no nível da solicitação.

Syntax

class IHttpContext  

Métodos

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

Nome	Descrição
AllocateRequestMemory	Aloca uma quantidade especificada de memória.
CancelIo	Cancela todas as operações de envio ou recebimento pendentes.
CloneContext	Cria um clone do contexto de solicitação atual.
DisableNotifications	Desabilita notificações específicas pendentes para essa solicitação no módulo atual.
Executerequest	Executa uma solicitação filho.
GetApplication	Recupera o contêiner do aplicativo para o contexto atual.
Getconnection	Recupera o contêiner de conexão para o contexto atual.
GetCurrentExecutionStats	Recupera as estatísticas de execução para o contexto atual.
GetExecuteFlags	Recupera os sinalizadores de execução para o contexto atual.
Getfileinfo	Recupera o contêiner de informações de arquivo para o contexto atual.
GetIsLastNotification	Indica se mais notificações estão pendentes para essa solicitação no host do módulo atual.
Getmetadata	Recupera o contêiner de metadados para o contexto de solicitação atual.
GetModuleContextContainer	Recupera o contêiner de contexto do módulo para o contexto atual.
GetNextNotification	Recupera a próxima notificação para o host do módulo atual.
GetParentContext	Recupera um ponteiro para o contexto pai para o contexto atual.
GetPhysicalPath	Recupera o caminho físico para a solicitação atual.
Getrequest	Retorna o contêiner de solicitação HTTP para o contexto atual.
Getresponse	Retorna o contêiner de resposta HTTP para o contexto atual.
GetResponseHeadersSent	Determina se os cabeçalhos de resposta HTTP foram enviados ao cliente.
GetRootContext	Recupera um ponteiro para o contexto raiz do contexto atual.
GetScriptMap	Recupera o contêiner de mapa de script para o contexto atual.
GetScriptName	Recupera a URL da solicitação atual.
GetScriptTranslated	Recupera o caminho físico da solicitação atual.
GetServerVarChanges	Recupera as alterações nas variáveis de servidor para o contexto atual.
Getservervariable	Recupera uma variável de servidor específica.
Getsite	Recupera o contêiner de informações do site para o contexto atual.
GetTraceContext	Recupera o contêiner de contexto de rastreamento para o contexto atual.
GetUrlInfo	Recupera o contêiner de informações de URL para o contexto atual.
Getuser	Recupera o contêiner de informações do usuário para o contexto atual.
IndicateCompletion	Indica a conclusão do trabalho assíncrono e solicita que o IIS retome a execução no thread de chamada.
MapHandler	Mapeia um manipulador para um par de verbos HTTP e URL de atribuição em um site.
Mappath	Retorna o caminho físico de uma URL relativa.
NotifyCustomNotification	Gera uma notificação personalizada no nível da solicitação.
PostCompletion	Indica a conclusão do trabalho assíncrono e solicita que o IIS enfileira a execução no pool de threads.
ReleaseClonedContext	Libera uma instância clonada IHttpContext .
SetRequestHandled	Indica que os manipuladores da solicitação atual foram concluídos.
SetServerVariable	Define uma variável de servidor como um valor especificado.

Classes derivadas

Nome	Descrição
IHttpContext2	Representa o reprocessamento de uma solicitação HTTP e permite a recuperação de informações sobre o usuário original durante a operação assíncrona.
IHttpContext3	Representa o reprocessamento de uma solicitação HTTP e permite suporte adicional para operações assíncronas.
IHttpContext4	Representa o reprocessamento de uma solicitação HTTP e permite suporte adicional para operações de diagnóstico.

Comentários

A IHttpContext interface representa a interface programática main para módulos HTTP acessarem informações sobre o contexto atual no nível da solicitação. Essa interface recupera várias interfaces adicionais que você pode usar ao escrever módulos HTTP.

Por exemplo, os GetRequest métodos e GetResponse recuperam, respectivamente, as interfaces IHttpRequest e IHttpResponse para o contexto atual. Essas interfaces permitem que os desenvolvedores acessem ou modifiquem o corpo da solicitação e o corpo da resposta, cabeçalhos HTTP, comportamento do servidor e assim por diante.

O IIS 7 permite que você crie e execute contextos filho por meio da IHttpContext interface usando os CloneContextmétodos , ExecuteRequeste ReleaseClonedContext . O IIS também fornece os métodos e GetRootContext para ajudar os GetParentContext desenvolvedores a escrever módulos HTTP que podem alterar o comportamento dependendo se o contexto atual é um contexto raiz, filho ou pai.

IHttpContext também fornece vários métodos para ajudar os desenvolvedores a controlar o comportamento das notificações. Por exemplo, você pode usar o DisableNotifications método para desabilitar notificações ou o GetIsLastNotification método para determinar se há notificações restantes. Além disso, você pode usar o GetNextNotification método para mesclar notificações ou o NotifyCustomNotification método para gerar uma notificação personalizada.

Requisitos

Type	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.0 no Windows Server 2012 R2 - IIS 10.0 no Windows Server 2016
Produto	- 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
parâmetro	Httpserv.h

Consulte Também

Web Server Core Interfaces