Partage via


HttpContext Classe

Définition

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
HttpContext
Implémente

Exemples

L’exemple suivant montre comment accéder aux propriétés de l’objet et les HttpContext 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 reçoivent une référence à un HttpContext objet pour la requête HTTP actuelle. L’objet fournit l’accès aux propriétés intrinsèques Request, Responseet Server pour la requête.

Important

Cet objet est prêt pour le garbage collection lorsque le HttpRequest est terminé. Son utilisation une fois la requête terminée peut entraîner un comportement non défini, tel qu’un NullReferenceException.

Cet objet n’est disponible que dans le thread contrôlé par ASP.NET. L’utilisation dans les threads d’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.

Méthodes d’extension

GetKeyedService<T>(IServiceProvider, Object)

Obtient un service de type T à partir de .IServiceProvider

GetKeyedServices(IServiceProvider, Type, Object)

Obtient une énumération des services de type serviceType à partir de IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Obtient une énumération des services de type T à partir de IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Obtient un service de type serviceType à partir de .IServiceProvider

GetRequiredKeyedService<T>(IServiceProvider, Object)

Obtient un service de type T à partir de .IServiceProvider

CreateAsyncScope(IServiceProvider)

Crée un AsyncServiceScope qui peut être utilisé pour résoudre des services délimités.

CreateScope(IServiceProvider)

Crée un IServiceScope qui peut être utilisé pour résoudre des services délimités.

GetRequiredService(IServiceProvider, Type)

Obtient le service de type serviceType à partir du IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Obtient le service de type T à partir du IServiceProvider.

GetService<T>(IServiceProvider)

Obtient le service de type T à partir du IServiceProvider.

GetServices(IServiceProvider, Type)

Obtient une énumération des services de type serviceType à partir du IServiceProvider.

GetServices<T>(IServiceProvider)

Obtient une énumération des services de type T à partir du IServiceProvider.

GetFakeLogCollector(IServiceProvider)

Obtient l’objet qui collecte les enregistrements de journal envoyés au faux journal.

GetFakeRedactionCollector(IServiceProvider)

Obtient le faux collecteur de redacteur instance à partir du conteneur d’injection de dépendances.

S’applique à

Voir aussi