Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

HttpContext, classe

.NET Framework 4

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

System.Object
  System.Web.HttpContext

Espace de noms :  System.Web
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public sealed class HttpContext : IServiceProvider

Le type HttpContext expose les membres suivants.

  Nom Description
Méthode publique HttpContext(HttpWorkerRequest) Initialise une nouvelle instance de la classe HttpContext avec le nom de l'objet de requête de tâche spécifié.
Méthode publique HttpContext(HttpRequest, HttpResponse) Initialise une nouvelle instance de la classe HttpContext avec des objets de requête et de réponse.
Début
  Nom Description
Propriété publique AllErrors Obtient un tableau d'erreurs accumulées pendant le traitement d'une requête HTTP.
Propriété publique Application Obtient l'objet HttpApplicationState pour la requête HTTP actuelle.
Propriété publique ApplicationInstance Obtient ou définit l'objet HttpApplication pour la requête HTTP actuelle.
Propriété publique Cache Obtient le Cache pour le domaine d'application actuel.
Propriété publique Membre statique Current Obtient ou définit l'objet HttpContext pour la requête HTTP actuelle.
Propriété publique CurrentHandler Obtient l'objet IHttpHandler qui représente le gestionnaire en cours.
Propriété publique CurrentNotification Obtient une valeur RequestNotification qui indique quel événement HttpApplication est en cours de traitement.
Propriété publique Error Obtient la première erreur (éventuelle) accumulée pendant le traitement de la requête HTTP.
Propriété publique Handler Obtient ou définit l'objet IHttpHandler chargé de traiter la requête HTTP actuelle.
Propriété publique IsCustomErrorEnabled Obtient une valeur indiquant si les erreurs personnalisées sont autorisées pour la requête HTTP actuelle.
Propriété publique IsDebuggingEnabled Obtient une valeur indiquant si la requête HTTP actuelle est en mode débogage.
Propriété publique IsPostNotification Obtient une valeur qui indique si l'événement ASP.NET actuel est considéré comme un post-événement.
Propriété publique 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.
Propriété publique PreviousHandler Obtient l'objet IHttpHandler pour le gestionnaire parent.
Propriété publique Profile Obtient l'objet ProfileBase pour le profil utilisateur actuel.
Propriété publique Request Obtient l'objet HttpRequest pour la requête HTTP actuelle.
Propriété publique Response Obtient l'objet HttpResponse pour la réponse HTTP actuelle.
Propriété publique Server Obtient l'objet HttpServerUtility qui fournit les méthodes utilisées dans le traitement de requêtes Web.
Propriété publique Session Obtient l'objet HttpSessionState pour la requête HTTP actuelle.
Propriété publique 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.
Propriété publique Timestamp Obtient l'horodatage initial de la requête HTTP actuelle.
Propriété publique Trace Obtient l'objet TraceContext pour la réponse HTTP actuelle.
Propriété publique User Obtient ou définit les informations de sécurité pour la requête HTTP actuelle.
Début
  Nom Description
Méthode publique AddError Ajoute une exception à la collection d'exceptions pour la requête HTTP actuelle.
Méthode publique ClearError Efface toutes les erreurs pour la requête HTTP actuelle.
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique Membre statique GetAppConfig Obsolète. Retourne les informations de configuration demandées pour l'application actuelle.
Méthode publique GetConfig Obsolète. Retourne les informations de configuration demandées pour la requête HTTP actuelle.
Méthode publique Membre statique GetGlobalResourceObject(String, String) Obtient un objet ressource au niveau de l'application selon les propriétés ClassKey et ResourceKey spécifiées.
Méthode publique Membre statique 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.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique Membre statique GetLocalResourceObject(String, String) Obtient un objet ressource au niveau de la page selon les propriétés VirtualPath et ResourceKey spécifiées.
Méthode publique Membre statique 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.
Méthode publique GetSection Obtient une section de configuration spécifiée pour la configuration par défaut de l'application actuelle.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode publique RemapHandler Vous permet de spécifier un gestionnaire pour la requête.
Méthode publique RewritePath(String) Réécrit l'URL à l'aide du chemin d'accès donné.
Méthode publique 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é.
Méthode publique 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.
Méthode publique 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.
Méthode publique SetSessionStateBehavior Définit le type de comportement d'état de session requis afin de prendre en charge une requête HTTP.
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Début
  Nom Description
Implémentation d'interface explicite Méthode privée IServiceProvider.GetService Infrastructure. Retourne un objet pour le type de service actuel.
Début

Les classes qui héritent des interfaces IHttpModule et IHttpHandler reçoivent une référence à un objet HttpContext pour la requête HTTP actuelle. L'objet fournit l'accès aux propriétés Request, Response et Server pour la requête.

Un projet de site Web Visual Studio contenant du code source est disponible pour accompagner cette rubrique : Download.

L'exemple de code 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 via la propriété Context de l'objet Page.

C#
VB
Copier 

<%@ 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>

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ