IHttpContext, interface

Définit un objet qui représente le contexte de traitement pour les opérations au niveau de la demande.

Syntaxe

class IHttpContext  

Méthodes

Le tableau suivant répertorie les méthodes exposées par la IHttpContext classe .

Nom	Description
AllocateRequestMemory	Alloue une quantité de mémoire spécifiée.
CancelIo	Annule toutes les opérations d’envoi ou de réception en attente.
CloneContext	Crée un clone du contexte de requête actuel.
DisableNotifications	Désactive les notifications spécifiques qui sont en attente pour cette demande dans le module actuel.
ExecuteRequest	Exécute une requête enfant.
GetApplication	Récupère le conteneur d’application pour le contexte actuel.
GetConnection	Récupère le conteneur de connexion pour le contexte actuel.
GetCurrentExecutionStats	Récupère les statistiques d’exécution pour le contexte actuel.
GetExecuteFlags	Récupère les indicateurs d’exécution pour le contexte actuel.
GetFileInfo	Récupère le conteneur d’informations de fichier pour le contexte actuel.
GetIsLastNotification	Indique si d’autres notifications sont en attente pour cette demande dans l’hôte de module actuel.
GetMetadata	Récupère le conteneur de métadonnées pour le contexte de requête actuel.
GetModuleContextContainer	Récupère le conteneur de contexte de module pour le contexte actuel.
GetNextNotification	Récupère la notification suivante pour l’hôte de module actuel.
GetParentContext	Récupère un pointeur vers le contexte parent pour le contexte actuel.
GetPhysicalPath	Récupère le chemin d’accès physique de la requête actuelle.
GetRequest	Retourne le conteneur de requêtes HTTP pour le contexte actuel.
Getresponse	Retourne le conteneur de réponse HTTP pour le contexte actuel.
GetResponseHeadersSent	Détermine si les en-têtes de réponse HTTP ont été envoyés au client.
GetRootContext	Récupère un pointeur vers le contexte racine du contexte actuel.
GetScriptMap	Récupère le conteneur de mappage de script pour le contexte actuel.
GetScriptName	Récupère l’URL de la requête actuelle.
GetScriptTranslated	Récupère le chemin physique de la requête actuelle.
GetServerVarChanges	Récupère les modifications apportées aux variables de serveur pour le contexte actuel.
GetServerVariable	Récupère une variable de serveur spécifique.
GetSite	Récupère le conteneur d’informations de site pour le contexte actuel.
GetTraceContext	Récupère le conteneur de contexte de trace pour le contexte actuel.
GetUrlInfo	Récupère le conteneur d’informations d’URL pour le contexte actuel.
GetUser	Récupère le conteneur d’informations utilisateur pour le contexte actuel.
IndicateCompletion	Indique l’achèvement du travail asynchrone et demande à IIS de reprendre l’exécution sur le thread appelant.
MapHandler	Mappe un gestionnaire pour une paire d’URL et de verbes HTTP sur un site.
MapPath	Retourne le chemin physique d’une URL relative.
NotifyCustomNotification	Déclenche une notification personnalisée au niveau de la demande.
PostCompletion	Indique l’achèvement du travail asynchrone et demande à IIS de mettre en file d’attente l’exécution vers le pool de threads.
ReleaseClonedContext	Libère un instance cloné IHttpContext .
SetRequestHandled	Indique que les gestionnaires de la requête actuelle sont terminés.
SetServerVariable	Définit une variable serveur sur une valeur spécifiée.

Classes dérivées

Nom	Description
IHttpContext2	Représente le retraitement d’une requête HTTP et permet la récupération d’informations sur l’utilisateur d’origine pendant l’opération asynchrone.
IHttpContext3	Représente le retraitement d’une requête HTTP et permet une prise en charge supplémentaire pour les opérations asynchrones.
IHttpContext4	Représente le retraitement d’une requête HTTP et permet une prise en charge supplémentaire pour les opérations de diagnostic.

Remarques

L’interface IHttpContext représente l’interface programmatique main pour les modules HTTP afin d’accéder aux informations sur le contexte actuel au niveau de la requête. Cette interface récupère plusieurs interfaces supplémentaires que vous pouvez utiliser lors de l’écriture de modules HTTP.

Par exemple, les GetRequest méthodes et GetResponse récupèrent, respectivement, les interfaces IHttpRequest et IHttpResponse pour le contexte actuel. Ces interfaces permettent aux développeurs d’accéder ou de modifier le corps de la requête et le corps de la réponse, les en-têtes HTTP, le comportement du serveur, etc.

IIS 7 vous permet de créer et d’exécuter des contextes enfants via l’interface IHttpContext à l’aide des CloneContextméthodes , ExecuteRequestet ReleaseClonedContext . IIS fournit également les GetParentContext méthodes et GetRootContext pour aider les développeurs à écrire des modules HTTP qui peuvent changer de comportement selon que le contexte actuel est un contexte racine, enfant ou parent.

IHttpContext fournit également plusieurs méthodes pour aider les développeurs à contrôler le comportement des notifications. Par exemple, vous pouvez utiliser la méthode pour désactiver les DisableNotifications notifications ou la GetIsLastNotification méthode pour déterminer s’il reste des notifications. En outre, vous pouvez utiliser la méthode pour fusionner des GetNextNotification notifications ou la NotifyCustomNotification méthode pour déclencher une notification personnalisée.

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.0 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- 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
En-tête	Httpserv.h

Voir aussi

Interfaces principales du serveur web