HttpContext Classe

Référence

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Encapsule toutes les informations spécifiques au protocole HTTP relatives à une requête HTTP individuelle.

public ref class HttpContext sealed : IServiceProvider

public sealed class HttpContext : IServiceProvider

type HttpContext = class
    interface IServiceProvider

Public NotInheritable Class HttpContext
Implements IServiceProvider

Héritage: Object
HttpContext

Implémente: IServiceProvider

Exemples

L’exemple suivant montre comment accéder aux propriétés de l’objet HttpContext et les afficher. Le contexte de la requête HTTP actuelle est accessible à l’aide de la Context propriété de l’objet Page .

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        // The HttpContext associated with the page can be accessed by the Context property.
        System.Text.StringBuilder sb = new System.Text.StringBuilder();
        // Use the current HttpContext object to determine if custom errors are enabled.
        sb.Append("Is custom errors enabled: " +
            Context.IsCustomErrorEnabled.ToString() + "<br/>");

        // Use the current HttpContext object to determine if debugging is enabled.
        sb.Append("Is debugging enabled: " +
            Context.IsDebuggingEnabled.ToString() + "<br/>");

        // Use the current HttpContext object to access the current TraceContext object.
        sb.Append("Trace Enabled: " +
            Context.Trace.IsEnabled.ToString() + "<br/>");

        // Use the current HttpContext object to access the current HttpApplicationState object.
        sb.Append("Number of items in Application state: " +
            Context.Application.Count.ToString() + "<br/>");

        // Use the current HttpContext object to access the current HttpSessionState object.
        // Session state may not be configured.
        try
        {
            sb.Append("Number of items in Session state: " +
                Context.Session.Count.ToString() + "<br/>");
        }
        catch
        {
            sb.Append("Session state not enabled. <br/>");
        }

        // Use the current HttpContext object to access the current Cache object.
        sb.Append("Number of items in the cache: " +
            Context.Cache.Count.ToString() + "<br/>");

        // Use the current HttpContext object to determine the timestamp for the current HTTP Request.
        sb.Append("Timestamp for the HTTP request: " +
            Context.Timestamp.ToString() + "<br/>");

        // Assign StringBuilder object to output label.
        OutputLabel.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpContext Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       Using the current HttpContext to get information about the current page.
       <br />
       <asp:Label id="OutputLabel" runat="server"></asp:Label>           
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        ' The HttpContext associated with the page can be accessed by the Context property.
        Dim sb As New System.Text.StringBuilder()

        ' Use the current HttpContext object to determine if custom errors are enabled.
        sb.Append("Is custom errors enabled: " & _
            Context.IsCustomErrorEnabled.ToString() & "<br/>")

        ' Use the current HttpContext object to determine if debugging is enabled.
        sb.Append("Is debugging enabled: " & _
            Context.IsDebuggingEnabled.ToString() & "<br/>")

        ' Use the current HttpContext object to access the current TraceContext object.
        sb.Append("Trace Enabled: " & _
            Context.Trace.IsEnabled.ToString() & "<br/>")

        ' Use the current HttpContext object to access the current HttpApplicationState object.
        sb.Append("Number of items in Application state: " & _
            Context.Application.Count.ToString() & "<br/>")

        ' Use the current HttpContext object to access the current HttpSessionState object.
        ' Session state may not be configured.
        Try
            sb.Append("Number of items in Session state: " & _
                Context.Session.Count.ToString() & "<br/>")
        Catch ex As Exception
            sb.Append("Session state not enabled. <br/>")
        End Try

        ' Use the current HttpContext object to access the current Cache object.
        sb.Append("Number of items in the cache: " & _
            Context.Cache.Count.ToString() & "<br/>")

        ' Use the current HttpContext object to determine the timestamp for the current HTTP Request.
        sb.Append("Timestamp for the HTTP request: " & _
            Context.Timestamp.ToString() & "<br/>")

        ' Assign StringBuilder object to output label.
        OutputLabel.Text = sb.ToString()
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpContext Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       Using the current HttpContext to get information about the current page.
       <br />
       <asp:Label id="OutputLabel" runat="server"></asp:Label>           
    </div>
    </form>
</body>
</html>

Remarques

Les classes qui héritent des IHttpModule interfaces et IHttpHandler qui héritent sont fournies une référence à un HttpContext objet pour la requête HTTP actuelle. L’objet fournit l’accès à l’intrinsèque Request, Responseet Server aux propriétés de la requête.

Important

Cet objet est prêt pour le garbage collection lorsque l’opération HttpRequest est terminée. Son utilisation après la fin de la requête peut entraîner un comportement non défini, tel qu’un NullReferenceException.

Cet objet est disponible uniquement dans le thread contrôlé par ASP.NET. L’utilisation dans les threads en arrière-plan peut entraîner un comportement non défini.

Constructeurs

HttpContext(HttpRequest, HttpResponse)	Initialise une nouvelle instance de la classe HttpContext avec les objets de requête et de réponse spécifiés.
HttpContext(HttpWorkerRequest)	Initialise une nouvelle instance de la classe HttpContext qui utilise l'objet de requête de tâche spécifié.

Propriétés

AllErrors	Obtient un tableau d'erreurs accumulées pendant le traitement d'une requête HTTP.
AllowAsyncDuringSyncStages	Obtient ou définit une valeur qui indique si les opérations asynchrones sont autorisées pendant le traitement de requête ASP.NET alors qu'elles ne sont pas attendues.
Application	Obtient l'objet HttpApplicationState pour la requête HTTP actuelle.
ApplicationInstance	Obtient ou définit l'objet HttpApplication pour la requête HTTP actuelle.
AsyncPreloadMode	Obtient ou définit un objet qui contient les indicateurs qui concernent le mode de préchargement asynchrone.
Cache	Obtient l'objet Cache pour le domaine d'application actuel.
Current	Obtient ou définit l'objet HttpContext pour la requête HTTP actuelle.
CurrentHandler	Obtient l'objet IHttpHandler qui représente le gestionnaire en cours d'exécution.
CurrentNotification	Obtient une valeur RequestNotification qui indique quel événement HttpApplication est en cours de traitement.
Error	Obtient la première erreur (éventuelle) accumulée pendant le traitement de la requête HTTP.
Handler	Obtient ou définit l'objet IHttpHandler chargé de traiter la requête HTTP actuelle.
IsCustomErrorEnabled	Obtient une valeur indiquant si les erreurs personnalisées sont activées pour la requête HTTP actuelle.
IsDebuggingEnabled	Obtient une valeur indiquant si la requête HTTP actuelle est en mode débogage.
IsPostNotification	Obtient une valeur qui est le point de traitement actuel dans le pipeline ASP.NET juste après la fin du traitement d'un événement HttpApplication.
IsWebSocketRequest	Obtient une valeur qui indique si la requête est une requête AspNetWebSocket.
IsWebSocketRequestUpgrading	Obtient une valeur qui indique si la connexion subit une mise à niveau d'une connexion HTTP vers une connexion AspNetWebSocket.
Items	Obtient une collection clé/valeur qui peut être utilisée pour organiser et partager les données entre une interface IHttpModule et une interface IHttpHandler pendant une requête HTTP.
PageInstrumentation	Obtient une référence à l'instance du service d'instrumentation de page pour cette requête.
PreviousHandler	Obtient l'objet IHttpHandler pour le gestionnaire parent.
Profile	Obtient l'objet ProfileBase pour le profil utilisateur actuel.
Request	Obtient l'objet HttpRequest pour la requête HTTP actuelle.
Response	Obtient l'objet HttpResponse pour la réponse HTTP actuelle.
Server	Obtient l'objet HttpServerUtility qui fournit les méthodes utilisées dans le traitement des requêtes web.
Session	Obtient l'objet HttpSessionState pour la requête HTTP actuelle.
SkipAuthorization	Obtient ou définit une valeur qui spécifie si l'objet UrlAuthorizationModule doit ignorer le contrôle d'autorisation pour la requête actuelle.
ThreadAbortOnTimeout	Obtient ou définit une valeur qui spécifie si le runtime ASP.NET doit appeler Abort() sur le thread qui résout cette requête lorsqu'elle a expiré.
Timestamp	Obtient l'horodatage initial de la requête HTTP actuelle.
Trace	Obtient l'objet TraceContext pour la réponse HTTP actuelle.
User	Obtient ou définit les informations de sécurité pour la requête HTTP actuelle.
WebSocketNegotiatedProtocol	Obtient le protocole négocié qui a été envoyé du serveur au client pour une connexion AspNetWebSocket.
WebSocketRequestedProtocols	Obtient la liste ordonnée des protocoles demandés par le client.

Méthodes

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	Accepte une demande AspNetWebSocket à l'aide de la fonction utilisateur spécifiée.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	Accepte une demande AspNetWebSocket à l'aide de la fonction utilisateur et de l'objet d'options spécifiés.
AddError(Exception)	Ajoute une exception à la collection d'exceptions pour la requête HTTP actuelle.
AddOnRequestCompleted(Action<HttpContext>)	Déclenche un événement virtuel qui se produit lorsque le composant HTTP de la requête se termine.
ClearError()	Efface toutes les erreurs pour la requête HTTP actuelle.
DisposeOnPipelineCompleted(IDisposable)	Permet d'appeler la méthode Dispose() d'un objet lorsque la partie de connexion AspNetWebSocket de cette demande est terminée.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetAppConfig(String)	Obsolète. Retourne les informations de configuration demandées pour l'application actuelle.
GetConfig(String)	Obsolète. Retourne les informations de configuration demandées pour la requête HTTP actuelle.
GetGlobalResourceObject(String, String)	Obtient un objet de ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées.
GetGlobalResourceObject(String, String, CultureInfo)	Obtient un objet de ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées et selon l'objet CultureInfo.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLocalResourceObject(String, String)	Obtient un objet de ressource au niveau de la page selon les propriétés VirtualPath et ResourceKey spécifiées.
GetLocalResourceObject(String, String, CultureInfo)	Obtient un objet de ressource au niveau de la page selon les propriétés VirtualPath et ResourceKey spécifiées et selon l'objet CultureInfo.
GetSection(String)	Obtient une section de configuration spécifiée pour la configuration par défaut de l'application actuelle.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RemapHandler(IHttpHandler)	Vous permet de spécifier un gestionnaire pour la requête.
RewritePath(String)	Réécrit l’URL à l’aide du chemin d’accès donné.
RewritePath(String, Boolean)	Réécrit l'URL à l'aide du chemin d'accès donné et d'une valeur booléenne qui spécifie si le chemin d'accès virtuel pour les ressources de serveur est modifié.
RewritePath(String, String, String)	Réécrit l’URL en utilisant le chemin d’accès, les informations relatives au chemin d’accès et les informations de la chaîne de requête donnés.
RewritePath(String, String, String, Boolean)	Réécrit l’URL à l’aide du chemin d’accès virtuel donné, des informations relatives au chemin d’accès, des informations de chaîne de requête et d’une valeur booléenne qui spécifie si le chemin d’accès client a pour valeur le chemin d’accès de réécriture.
SetSessionStateBehavior(SessionStateBehavior)	Définit le type de comportement d'état de session nécessaire pour prendre en charge une requête HTTP.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IServiceProvider.GetService(Type)

Retourne un objet pour le type de service actuel.

S’applique à