Condividi tramite


Interfaccia IHttpContext

Definisce un oggetto che rappresenta il contesto di elaborazione per le operazioni a livello di richiesta.

Sintassi

class IHttpContext  

Metodi

Nella tabella seguente sono elencati i metodi esposti dalla IHttpContext classe .

Nome Descrizione
AllocateRequestMemory Alloca una quantità di memoria specificata.
CancelIo Annulla tutte le operazioni di invio o ricezione in sospeso.
CloneContext Crea un clone del contesto di richiesta corrente.
DisableNotifications Disabilita le notifiche specifiche in sospeso per questa richiesta nel modulo corrente.
ExecuteRequest Esegue una richiesta figlio.
GetApplication Recupera il contenitore dell'applicazione per il contesto corrente.
GetConnection Recupera il contenitore di connessione per il contesto corrente.
GetCurrentExecutionStats Recupera le statistiche di esecuzione per il contesto corrente.
GetExecuteFlags Recupera i flag di esecuzione per il contesto corrente.
Getfileinfo Recupera il contenitore di informazioni sul file per il contesto corrente.
GetIsLastNotification Indica se sono in sospeso altre notifiche per questa richiesta nell'host del modulo corrente.
Getmetadata Recupera il contenitore di metadati per il contesto di richiesta corrente.
GetModuleContextContainer Recupera il contenitore di contesto del modulo per il contesto corrente.
GetNextNotification Recupera la notifica successiva per l'host del modulo corrente.
GetParentContext Recupera un puntatore al contesto padre per il contesto corrente.
GetPhysicalPath Recupera il percorso fisico per la richiesta corrente.
Getrequest Restituisce il contenitore di richieste HTTP per il contesto corrente.
Getresponse Restituisce il contenitore di risposta HTTP per il contesto corrente.
GetResponseHeadersSent Determina se le intestazioni di risposta HTTP sono state inviate al client.
GetRootContext Recupera un puntatore al contesto radice per il contesto corrente.
GetScriptMap Recupera il contenitore della mappa di script per il contesto corrente.
GetScriptName Recupera l'URL per la richiesta corrente.
GetScriptTranslated Recupera il percorso fisico della richiesta corrente.
GetServerVarChanges Recupera le modifiche apportate alle variabili del server per il contesto corrente.
GetServerVariable Recupera una variabile server specifica.
GetSite Recupera il contenitore di informazioni del sito per il contesto corrente.
GetTraceContext Recupera il contenitore del contesto di traccia per il contesto corrente.
GetUrlInfo Recupera il contenitore di informazioni URL per il contesto corrente.
Getuser Recupera il contenitore di informazioni utente per il contesto corrente.
IndicateCompletion Indica il completamento del lavoro asincrono e richiede a IIS di riprendere l'esecuzione nel thread chiamante.
MapHandler Esegue il mapping di un gestore per un URL di assegnare un URL, una coppia di verbi HTTP in un sito.
Mappath Restituisce il percorso fisico di un URL relativo.
NotifyCustomNotification Genera una notifica personalizzata a livello di richiesta.
PostCompletion Indica il completamento del lavoro asincrono e richiede a IIS di accodare l'esecuzione al pool di thread.
ReleaseClonedContext Rilascia un'istanza clonata IHttpContext .
SetRequestHandled Indica che i gestori per la richiesta corrente sono stati completati.
SetServerVariable Imposta una variabile server su un valore specificato.

Classi derivate

Nome Descrizione
IHttpContext2 Rappresenta la rielaborazione di una richiesta HTTP e consente il recupero di informazioni sull'utente originale durante l'operazione asincrona.
IHttpContext3 Rappresenta la rielaborazione di una richiesta HTTP e abilita il supporto aggiuntivo per le operazioni asincrone.
IHttpContext4 Rappresenta la rielaborazione di una richiesta HTTP e abilita il supporto aggiuntivo per le operazioni di diagnostica.

Commenti

L'interfaccia IHttpContext rappresenta l'interfaccia programmatica principale per i moduli HTTP per accedere alle informazioni sul contesto a livello di richiesta corrente. Questa interfaccia recupera diverse interfacce aggiuntive che è possibile usare per la scrittura di moduli HTTP.

Ad esempio, i GetRequest metodi e GetResponse recuperano, rispettivamente, le interfacce IHttpRequest e IHttpResponse per il contesto corrente. Queste interfacce consentono agli sviluppatori di accedere o modificare il corpo della richiesta e il corpo della risposta, le intestazioni HTTP, il comportamento del server e così via.

IIS 7 consente di creare ed eseguire contesti figlio tramite l'interfaccia IHttpContext usando i CloneContextmetodi , ExecuteRequeste ReleaseClonedContext . IIS fornisce anche i GetParentContext metodi e GetRootContext per consentire agli sviluppatori di scrivere moduli HTTP che possono modificare il comportamento a seconda che il contesto corrente sia un contesto radice, figlio o padre.

IHttpContext fornisce anche diversi metodi per aiutare gli sviluppatori a controllare il comportamento delle notifiche. Ad esempio, è possibile usare il DisableNotifications metodo per disabilitare le notifiche o il GetIsLastNotification metodo per determinare se sono presenti notifiche rimanenti. Inoltre, è possibile usare il GetNextNotification metodo per unire le notifiche o il NotifyCustomNotification metodo per generare una notifica personalizzata.

Requisiti

Tipo Descrizione
Client - IIS 7.0 in Windows Vista
- IIS 7.5 in Windows 7
- IIS 8.0 in Windows 8
- IIS 10.0 in Windows 10
Server - IIS 7.0 in Windows Server 2008
- IIS 7.5 in Windows Server 2008 R2
- IIS 8.0 in Windows Server 2012
- IIS 8.0 in Windows Server 2012 R2
- IIS 10.0 in Windows Server 2016
Prodotto - 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
Intestazione Httpserv.h

Vedere anche

Interfacce Web Server Core