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 |