HttpContext HttpContext HttpContext HttpContext Class

Définition

Encapsule toutes les informations spécifiques au protocole HTTP relatives à une requête HTTP individuelle.Encapsulates all HTTP-specific information about an individual HTTP request.

public ref class HttpContext sealed : IServiceProvider
public sealed class HttpContext : IServiceProvider
type HttpContext = class
    interface IServiceProvider
Public NotInheritable Class HttpContext
Implements IServiceProvider
Héritage
HttpContextHttpContextHttpContextHttpContext
Implémente

Exemples

L’exemple suivant montre comment accéder aux propriétés de l’objet et HttpContext les afficher.The following example demonstrates how to access and display properties of the HttpContext object. Le contexte de la requête HTTP actuelle est accessible à l’aide Context de la propriété Page de l’objet.The context of the current HTTP request is accessed by using the Context property of the Page object.

<%@ 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 IHttpModule héritent IHttpHandler des interfaces et fournissent une référence à HttpContext un objet pour la requête HTTP actuelle.Classes that inherit the IHttpModule and IHttpHandler interfaces are provided a reference to an HttpContext object for the current HTTP request. L’objet fournit l’accès aux propriétés Request, Responseet Server intrinsèques de la demande.The object provides access to the intrinsic Request, Response, and Server properties for the request.

Important

Cet objet est prêt pour garbage collection lorsque HttpRequest est terminé.This object is ready for garbage collection when the HttpRequest is completed. Son utilisation après la fin de la requête peut entraîner un comportement indéfini, tel qu’un NullReferenceException.Its usage after the request completes could lead to undefined behavior, such as a NullReferenceException.

Cet objet est uniquement disponible dans le thread contrôlé par ASP.NET.This object is only available in the thread controlled by ASP.NET. L’utilisation dans les threads d’arrière-plan peut entraîner un comportement indéfini.Usage in background threads could lead to undefined behavior.

Constructeurs

HttpContext(HttpRequest, HttpResponse) HttpContext(HttpRequest, HttpResponse) HttpContext(HttpRequest, HttpResponse) HttpContext(HttpRequest, HttpResponse)

Initialise une nouvelle instance de la classe HttpContext avec des objets de requête et de réponse.Initializes a new instance of the HttpContext class by using the specified request and response objects.

HttpContext(HttpWorkerRequest) HttpContext(HttpWorkerRequest) HttpContext(HttpWorkerRequest) HttpContext(HttpWorkerRequest)

Initialise une nouvelle instance de la classe HttpContext qui utilise l'objet de requête de tâche spécifié.Initializes a new instance of the HttpContext class that uses the specified worker-request object.

Propriétés

AllErrors AllErrors AllErrors AllErrors

Obtient un tableau d'erreurs accumulées pendant le traitement d'une requête HTTP.Gets an array of errors accumulated while processing an HTTP request.

AllowAsyncDuringSyncStages AllowAsyncDuringSyncStages AllowAsyncDuringSyncStages 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.Gets or sets a value that indicates whether asynchronous operations are allowed during parts of ASP.NET request processing when they are not expected.

Application Application Application Application

Obtient l'objet HttpApplicationState pour la requête HTTP actuelle.Gets the HttpApplicationState object for the current HTTP request.

ApplicationInstance ApplicationInstance ApplicationInstance ApplicationInstance

Obtient ou définit l'objet HttpApplication pour la requête HTTP actuelle.Gets or sets the HttpApplication object for the current HTTP request.

AsyncPreloadMode AsyncPreloadMode AsyncPreloadMode AsyncPreloadMode

Obtient ou définit un objet qui contient les indicateurs qui concernent le mode de préchargement asynchrone.Gets or sets an object that contains flags that pertain to asynchronous preload mode.

Cache Cache Cache Cache

Obtient l'objet Cache pour le domaine d'application actuel.Gets the Cache object for the current application domain.

Current Current Current Current

Obtient ou définit l'objet HttpContext pour la requête HTTP actuelle.Gets or sets the HttpContext object for the current HTTP request.

CurrentHandler CurrentHandler CurrentHandler CurrentHandler

Obtient l'objet IHttpHandler qui représente le gestionnaire en cours.Gets the IHttpHandler object that represents the currently executing handler.

CurrentNotification CurrentNotification CurrentNotification CurrentNotification

Obtient une valeur RequestNotification qui indique quel événement HttpApplication est en cours de traitement.Gets a RequestNotification value that indicates the current HttpApplication event that is processing.

Error Error Error Error

Obtient la première erreur (éventuelle) accumulée pendant le traitement de la requête HTTP.Gets the first error (if any) accumulated during HTTP request processing.

Handler Handler Handler Handler

Obtient ou définit l'objet IHttpHandler chargé de traiter la requête HTTP actuelle.Gets or sets the IHttpHandler object responsible for processing the HTTP request.

IsCustomErrorEnabled IsCustomErrorEnabled IsCustomErrorEnabled IsCustomErrorEnabled

Obtient une valeur indiquant si les erreurs personnalisées sont autorisées pour la requête HTTP actuelle.Gets a value indicating whether custom errors are enabled for the current HTTP request.

IsDebuggingEnabled IsDebuggingEnabled IsDebuggingEnabled IsDebuggingEnabled

Obtient une valeur indiquant si la requête HTTP actuelle est en mode débogage.Gets a value indicating whether the current HTTP request is in debug mode.

IsPostNotification IsPostNotification IsPostNotification IsPostNotification

Obtient une valeur qui est le point de traitement actuel dans le pipeline ASP.NET juste après qu'un événement HttpApplication termine le traitement.Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.

IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest IsWebSocketRequest

Obtient une valeur qui indique si la requête possède une demande AspNetWebSocket.Gets a value that indicates whether the request is an AspNetWebSocket request.

IsWebSocketRequestUpgrading IsWebSocketRequestUpgrading IsWebSocketRequestUpgrading IsWebSocketRequestUpgrading

Obtient une valeur qui indique si la connexion effectue une mise à niveau d'une connexion HTTP vers une connexion AspNetWebSocket.Gets a value that indicates whether the connection is upgrading from an HTTP connection to an AspNetWebSocket connection.

Items Items Items 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.Gets a key/value collection that can be used to organize and share data between an IHttpModule interface and an IHttpHandler interface during an HTTP request.

PageInstrumentation PageInstrumentation PageInstrumentation PageInstrumentation

Obtient une référence à l'instance du service d'instrumentation de page pour cette requête.Gets a reference to the page-instrumentation service instance for this request.

PreviousHandler PreviousHandler PreviousHandler PreviousHandler

Obtient l'objet IHttpHandler pour le gestionnaire parent.Gets the IHttpHandler object for the parent handler.

Profile Profile Profile Profile

Obtient l'objet ProfileBase pour le profil utilisateur actuel.Gets the ProfileBase object for the current user profile.

Request Request Request Request

Obtient l'objet HttpRequest pour la requête HTTP actuelle.Gets the HttpRequest object for the current HTTP request.

Response Response Response Response

Obtient l'objet HttpResponse pour la réponse HTTP actuelle.Gets the HttpResponse object for the current HTTP response.

Server Server Server Server

Obtient l'objet HttpServerUtility qui fournit les méthodes utilisées dans le traitement de requêtes Web.Gets the HttpServerUtility object that provides methods used in processing Web requests.

Session Session Session Session

Obtient l'objet HttpSessionState pour la requête HTTP actuelle.Gets the HttpSessionState object for the current HTTP request.

SkipAuthorization SkipAuthorization SkipAuthorization 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.Gets or sets a value that specifies whether the UrlAuthorizationModule object should skip the authorization check for the current request.

ThreadAbortOnTimeout ThreadAbortOnTimeout ThreadAbortOnTimeout 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 lorsque la requête a expiré.Gets or sets a value that specifies whether the ASP.NET runtime should call Abort() on the thread that is servicing this request when the request times out.

Timestamp Timestamp Timestamp Timestamp

Obtient l'horodatage initial de la requête HTTP actuelle.Gets the initial timestamp of the current HTTP request.

Trace Trace Trace Trace

Obtient l'objet TraceContext pour la réponse HTTP actuelle.Gets the TraceContext object for the current HTTP response.

User User User User

Obtient ou définit les informations de sécurité pour la requête HTTP actuelle.Gets or sets security information for the current HTTP request.

WebSocketNegotiatedProtocol WebSocketNegotiatedProtocol WebSocketNegotiatedProtocol WebSocketNegotiatedProtocol

Obtient le protocole négocié qui a été envoyé du serveur au client pour une connexion du AspNetWebSocket.Gets the negotiated protocol that was sent from the server to the client for an AspNetWebSocket connection.

WebSocketRequestedProtocols WebSocketRequestedProtocols WebSocketRequestedProtocols WebSocketRequestedProtocols

Obtient la liste ordonnée des protocoles demandés par le client.Gets the ordered list of protocols requested by the client.

Méthodes

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>)

Accepte une demande de AspNetWebSocket à l'aide de la fonction utilisateur spécifiée.Accepts an AspNetWebSocket request using the specified user function.

AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions) AcceptWebSocketRequest(Func<AspNetWebSocketContext,Task>, AspNetWebSocketOptions)

Accepte une demande de AspNetWebSocket à l'aide de la fonction utilisateur et de l'objet d'options spécifiés.Accepts an AspNetWebSocket request using the specified user function and options object.

AddError(Exception) AddError(Exception) AddError(Exception) AddError(Exception)

Ajoute une exception à la collection d'exceptions pour la requête HTTP actuelle.Adds an exception to the exception collection for the current HTTP request.

AddOnRequestCompleted(Action<HttpContext>) AddOnRequestCompleted(Action<HttpContext>) AddOnRequestCompleted(Action<HttpContext>) AddOnRequestCompleted(Action<HttpContext>)

Déclenche un événement virtuel qui se produit lorsque le composant HTTP de la requête se termine.Raises a virtual event that occurs when the HTTP part of the request is ending.

ClearError() ClearError() ClearError() ClearError()

Efface toutes les erreurs pour la requête HTTP actuelle.Clears all errors for the current HTTP request.

DisposeOnPipelineCompleted(IDisposable) DisposeOnPipelineCompleted(IDisposable) DisposeOnPipelineCompleted(IDisposable) DisposeOnPipelineCompleted(IDisposable)

Active la méthode Dispose() d'un objet à appeler lorsque la partie de connexion AspNetWebSocket de cette demande est terminée.Enables an object's Dispose() method to be called when the AspNetWebSocket connection part of this request is completed.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAppConfig(String) GetAppConfig(String) GetAppConfig(String) GetAppConfig(String)

Retourne les informations de configuration demandées pour l'application actuelle.Returns requested configuration information for the current application.

GetConfig(String) GetConfig(String) GetConfig(String) GetConfig(String)

Retourne les informations de configuration demandées pour la requête HTTP actuelle.Returns requested configuration information for the current HTTP request.

GetGlobalResourceObject(String, String) GetGlobalResourceObject(String, String) GetGlobalResourceObject(String, String) GetGlobalResourceObject(String, String)

Obtient un objet ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

GetGlobalResourceObject(String, String, CultureInfo) GetGlobalResourceObject(String, String, CultureInfo) GetGlobalResourceObject(String, String, CultureInfo) GetGlobalResourceObject(String, String, CultureInfo)

Obtient un objet ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées et selon l'objet CultureInfo.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, and on the CultureInfo object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLocalResourceObject(String, String) GetLocalResourceObject(String, String) GetLocalResourceObject(String, String) GetLocalResourceObject(String, String)

Obtient un objet ressource au niveau de la page selon les propriétés VirtualPath et ResourceKey spécifiées.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties.

GetLocalResourceObject(String, String, CultureInfo) GetLocalResourceObject(String, String, CultureInfo) GetLocalResourceObject(String, String, CultureInfo) GetLocalResourceObject(String, String, CultureInfo)

Obtient un objet ressource au niveau de la page selon les propriétés VirtualPath et ResourceKey spécifiées et selon l'objet CultureInfo.Gets a page-level resource object based on the specified VirtualPath and ResourceKey properties, and on the CultureInfo object.

GetSection(String) GetSection(String) GetSection(String) GetSection(String)

Obtient une section de configuration spécifiée pour la configuration par défaut de l'application actuelle.Gets a specified configuration section for the current application's default configuration.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
RemapHandler(IHttpHandler) RemapHandler(IHttpHandler) RemapHandler(IHttpHandler) RemapHandler(IHttpHandler)

Vous permet de spécifier un gestionnaire pour la requête.Enables you to specify a handler for the request.

RewritePath(String) RewritePath(String) RewritePath(String) RewritePath(String)

Réécrit l'URL à l'aide du chemin d'accès donné.Rewrites the URL using the given path.

RewritePath(String, Boolean) RewritePath(String, Boolean) RewritePath(String, Boolean) RewritePath(String, Boolean)

Réécrit l'URL à l'aide du chemin d'accès donné et d'une valeur Boolean qui spécifie si le chemin d'accès virtuel pour les ressources de serveur est modifié.Rewrites the URL using the given path and a Boolean value that specifies whether the virtual path for server resources is modified.

RewritePath(String, String, String) RewritePath(String, String, String) RewritePath(String, String, String) 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.Rewrites the URL by using the given path, path information, and query string information.

RewritePath(String, String, String, Boolean) RewritePath(String, String, String, Boolean) RewritePath(String, String, String, Boolean) 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 Boolean qui spécifie si le chemin d'accès client a pour valeur le chemin d'accès de réécriture.Rewrites the URL using the given virtual path, path information, query string information, and a Boolean value that specifies whether the client file path is set to the rewrite path.

SetSessionStateBehavior(SessionStateBehavior) SetSessionStateBehavior(SessionStateBehavior) SetSessionStateBehavior(SessionStateBehavior) SetSessionStateBehavior(SessionStateBehavior)

Définit le type de comportement d'état de session requis afin de prendre en charge une requête HTTP.Sets the type of session state behavior that is required in order to support an HTTP request.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type) IServiceProvider.GetService(Type)

Retourne un objet pour le type de service actuel.Returns an object for the current service type.

S’applique à

Voir aussi