HttpContext Classe

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 à HTTP sur 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 sont IHttpHandler 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 une fois l’opération HttpRequest terminée. Son utilisation une fois la requête terminée 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 d’arrière-plan peut entraîner un comportement non défini.

Constructeurs

Nom	Description
HttpContext(HttpRequest, HttpResponse)	Initialise une nouvelle instance de la HttpContext classe à l’aide des objets de requête et de réponse spécifiés.
HttpContext(HttpWorkerRequest)	Initialise une nouvelle instance de la HttpContext classe qui utilise l’objet worker-request spécifié.

Propriétés

Nom	Description
AllErrors	Obtient un tableau d’erreurs accumulées lors du traitement d’une requête HTTP.
AllowAsyncDuringSyncStages	Obtient ou définit une valeur qui indique si les opérations asynchrones sont autorisées pendant les parties de ASP.NET traitement des demandes lorsqu’elles ne sont pas attendues.
Application	Obtient l’objet HttpApplicationState de la requête HTTP actuelle.
ApplicationInstance	Obtient ou définit l’objet HttpApplication de la requête HTTP actuelle.
AsyncPreloadMode	Obtient ou définit un objet qui contient des indicateurs relatifs au mode de préchargement asynchrone.
Cache	Obtient l’objet Cache du domaine d’application actuel.
Current	Obtient ou définit l’objet HttpContext de la requête HTTP actuelle.
CurrentHandler	Obtient l’objet IHttpHandler qui représente le gestionnaire en cours d’exécution.
CurrentNotification	Obtient une RequestNotification valeur qui indique l’événement actuel HttpApplication qui est en cours de traitement.
Error	Obtient la première erreur (le cas échéant) accumulée pendant le traitement des requêtes HTTP.
Handler	Obtient ou définit l’objet IHttpHandler responsable du traitement de la requête HTTP.
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 HttpApplication événement.
IsWebSocketRequest	Obtient une valeur qui indique si la requête est une AspNetWebSocket requête.
IsWebSocketRequestUpgrading	Obtient une valeur qui indique si la connexion est mise à niveau d’une connexion HTTP vers une AspNetWebSocket connexion.
Items	Obtient une collection clé/valeur qui peut être utilisée pour organiser et partager des données entre une IHttpModule interface et une IHttpHandler interface 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 du gestionnaire parent.
Profile	Obtient l’objet ProfileBase du profil utilisateur actuel.
Request	Obtient l’objet HttpRequest de la requête HTTP actuelle.
Response	Obtient l’objet HttpResponse de la réponse HTTP actuelle.
Server	Obtient l’objet HttpServerUtility qui fournit des méthodes utilisées dans le traitement des requêtes Web.
Session	Obtient l’objet HttpSessionState de la requête HTTP actuelle.
SkipAuthorization	Obtient ou définit une valeur qui spécifie si l’objet UrlAuthorizationModule doit ignorer la vérification d’autorisation de 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 effectue la maintenance de cette requête lorsque la requête expire.
Timestamp	Obtient l’horodatage initial de la requête HTTP actuelle.
Trace	Obtient l’objet TraceContext de la réponse HTTP actuelle.
User	Obtient ou définit des 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 AspNetWebSocket connexion.
WebSocketRequestedProtocols	Obtient la liste triée des protocoles demandés par le client.

Méthodes

Nom	Description
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)	Accepte une AspNetWebSocket demande à l’aide de la fonction utilisateur et de l’objet options spécifiés.
AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)	Accepte une AspNetWebSocket demande à l’aide de la fonction utilisateur spécifiée.
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 la partie HTTP de la requête se termine.
ClearError()	Efface toutes les erreurs pour la requête HTTP actuelle.
DisposeOnPipelineCompleted(IDisposable)	Permet à la méthode d’un Dispose() objet d’être appelée lorsque la AspNetWebSocket partie de connexion de cette requête 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, CultureInfo)	Obtient un objet de ressource au niveau de l’application en fonction des propriétés et ResourceKey des propriétés spécifiées ClassKey et de l’objetCultureInfo.
GetGlobalResourceObject(String, String)	Obtient un objet de ressource au niveau de l’application en fonction des propriétés et ResourceKey des propriétés spécifiéesClassKey.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLocalResourceObject(String, String, CultureInfo)	Obtient un objet de ressource au niveau de la page en fonction des propriétés et ResourceKey des propriétés spécifiées VirtualPath et de l’objetCultureInfo.
GetLocalResourceObject(String, String)	Obtient un objet de ressource au niveau de la page en fonction des propriétés et ResourceKey des propriétés spécifiéesVirtualPath.
GetSection(String)	Obtient une section de configuration spécifiée pour la configuration par défaut de l’application actuelle.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
RemapHandler(IHttpHandler)	Vous permet de spécifier un gestionnaire pour la demande.
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 virtuel des ressources du serveur est modifié.
RewritePath(String, String, String, Boolean)	Réécrit l’URL à l’aide du chemin d’accès virtuel, des informations de chemin d’accès, des informations de chaîne de requête et d’une valeur booléenne qui spécifie si le chemin du fichier client est défini sur le chemin de réécriture.
RewritePath(String, String, String)	Réécrit l’URL à l’aide du chemin d’accès, des informations de chemin d’accès et des informations de chaîne de requête donnés.
RewritePath(String)	Réécrit l’URL à l’aide du chemin donné.
SetSessionStateBehavior(SessionStateBehavior)	Définit le type de comportement d’état de session requis 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

Nom	Description
IServiceProvider.GetService(Type)	Retourne un objet pour le type de service actuel.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?