Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 |