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 |