Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

HttpResponse, classe

Encapsule les informations de réponse HTTP issues d'une opération ASP.NET.

System.Object
  System.Web.HttpResponse

Espace de noms :  System.Web
Assembly :  System.Web (dans System.Web.dll)

public sealed class HttpResponse

Le type HttpResponse expose les membres suivants.

  NomDescription
Méthode publiqueHttpResponseInfrastructure. Initialise une nouvelle instance de la classe HttpResponse.
Début

  NomDescription
Propriété publiqueBufferObtient ou définit une valeur qui indique si la sortie doit être placée en mémoire tampon et envoyée une fois que la réponse a été complètement traitée.
Propriété publiqueBufferOutputObtient ou définit une valeur qui indique si la sortie doit être placée en mémoire tampon et envoyée une fois que la page entière a été traitée.
Propriété publiqueCacheObtient la stratégie de mise en cache d'une page Web (délai d'expiration, confidentialité, clauses diverses).
Propriété publiqueCacheControlObtient ou définit l'en-tête HTTP Cache-Control correspondant à l'une des valeurs d'énumération HttpCacheability.
Propriété publiqueCharsetObtient ou définit le jeu de caractères HTTP du flux de sortie.
Propriété publiqueClientDisconnectedTokenObtient un objet de CancellationToken dépassé lors de la déconnexion du client.
Propriété publiqueContentEncodingObtient ou définit le jeu de caractères HTTP du flux de sortie.
Propriété publiqueContentTypeObtient ou définit le type MIME HTTP du flux de sortie.
Propriété publiqueCookiesObtient la collection de cookies constituant la réponse.
Propriété publiqueExpiresObtient ou définit, en minutes, le délai d'expiration d'une page mise en cache sur un navigateur. Si l'utilisateur retourne à la même page avant qu'elle n'expire, la version mise en cache est affichée. Expires est fourni pour des raisons de compatibilité avec les versions précédentes de ASP.
Propriété publiqueExpiresAbsoluteObtient ou définit la date et heure absolues auxquelles supprimer des informations présentes dans le cache. ExpiresAbsolute est fourni pour des raisons de compatibilité avec les versions précédentes de ASP.
Propriété publiqueFilterObtient ou définit un objet wrapping filter à utiliser pour modifier le corps d'une entité HTTP avant la transmission.
Propriété publiqueHeaderEncodingObtient ou définit un objet Encoding qui représente l'encodage du flux de sortie d'en-tête actuel.
Propriété publiqueHeadersObtient la collection d'en-têtes de réponse.
Propriété publiqueHeadersWritten[Supported in the .NET Framework 4.5.2 and later versions]Gets a value indicating whether the response headers have been written.
Propriété publiqueIsClientConnectedObtient une valeur indiquant si le client est encore connecté au serveur.
Propriété publiqueIsRequestBeingRedirectedObtient une valeur Boolean qui indique si le client est transféré vers un nouvel emplacement.
Propriété publiqueOutputPermet la sortie du texte dans le flux de réponse HTTP sortant.
Propriété publiqueOutputStreamPermet une sortie binaire vers le corps du contenu HTTP sortant.
Propriété publiqueRedirectLocationObtient ou définit la valeur de l'en-tête HTTP Location.
Propriété publiqueStatusDéfinit la ligne Status retournée vers le client.
Propriété publiqueStatusCodeObtient ou définit le code d'état HTTP du résultat retourné au client.
Propriété publiqueStatusDescriptionObtient ou définit la chaîne d'état HTTP du résultat retourné au client.
Propriété publiqueSubStatusCodeObtient ou définit une valeur qui qualifie le code d'état de la réponse.
Propriété publiqueSupportsAsyncFlushObtient une valeur qui indique si la connexion prend en charge les opérations de vidage asynchrones.
Propriété publiqueSuppressContentObtient ou définit une valeur indiquant si le contenu HTTP doit être envoyé au client.
Propriété publiqueSuppressDefaultCacheControlHeader[Supported in the .NET Framework 4.5.2 and later versions]Gets or sets a value indicating whether to suppress the default Cache Control: private header for the current HTTP response.
Propriété publiqueSuppressFormsAuthenticationRedirectObtient ou définit une valeur qui spécifie si la redirection d'authentification par formulaire à la page de connexion doit être supprimée.
Propriété publiqueTrySkipIisCustomErrorsObtient ou définit une valeur qui indique si les erreurs personnalisées d'IIS 7.0 sont désactivées.
Début

  NomDescription
Méthode publiqueAddCacheDependencyAssocie un jeu de dépendances de cache à la réponse pour faciliter l'invalidation de cette dernière si elle est stockée dans le cache de sortie et si les dépendances spécifiées changent.
Méthode publiqueAddCacheItemDependencies(ArrayList)Rend la validité d'une réponse mise en cache dépendante d'autres éléments présents dans le cache.
Méthode publiqueAddCacheItemDependencies(String[])Rend la validité d'un élément mis en cache dépendante d'un autre élément du cache.
Méthode publiqueAddCacheItemDependencyRend la validité d'une réponse mise en cache dépendante d'un autre élément présent dans le cache.
Méthode publiqueAddFileDependencies(ArrayList)Ajoute un groupe de noms de fichiers à la collection de noms de fichiers dont dépend la réponse en cours.
Méthode publiqueAddFileDependencies(String[])Ajoute un tableau de noms de fichiers à la collection de noms de fichiers dont dépend la réponse en cours.
Méthode publiqueAddFileDependencyAjoute un seul nom de fichier à la collection de noms de fichiers dont dépend la réponse en cours.
Méthode publiqueAddHeaderAjoute un en-tête HTTP au flux de sortie. AddHeader est fourni pour des raisons de compatibilité avec les versions précédentes de ASP.
Méthode publiqueAddOnSendingHeaders[Supported in the .NET Framework 4.5.2 and later versions]Registers a callback that the ASP.NET runtime will invoke immediately before response headers are sent for this request.
Méthode publiqueAppendCookieInfrastructure. Ajoute un cookie HTTP à la collection de cookies intrinsèque.
Méthode publiqueAppendHeaderAjoute un en-tête HTTP au flux de sortie.
Méthode publiqueAppendToLogAjoute des informations personnalisées au fichier journal IIS (Internet Information Services).
Méthode publiqueApplyAppPathModifierAjoute un ID de session au chemin d'accès virtuel si la session utilise un état de session Cookieless et retourne le chemin combiné. Si l'état de session Cookieless n'est pas utilisé, ApplyAppPathModifier retourne le chemin d'accès virtuel d'origine.
Méthode publiqueBeginFlushEnvoie la réponse actuellement en mémoire tampon au client.
Méthode publiqueBinaryWriteÉcrit une chaîne de caractères binaires dans le flux HTTP en sortie.
Méthode publiqueClearEfface le contenu de sortie du flux de la mémoire tampon.
Méthode publiqueClearContentEfface le contenu de sortie du flux de la mémoire tampon.
Méthode publiqueClearHeadersEfface tous les en-têtes dans le flux de la mémoire tampon.
Méthode publiqueCloseFerme la connexion du socket à un client.
Méthode publiqueDisableKernelCacheDésactive la mise en cache de noyau pour la réponse en cours.
Méthode publiqueDisableUserCacheDésactive la mise en cache en mode utilisateur IIS pour cette réponse.
Méthode publiqueEndEnvoie l'ensemble de la sortie actuellement dans la mémoire tampon au client, arrête l'exécution de la page et déclenche l'événement EndRequest.
Méthode publiqueEndFlushTermine une opération de vidage asynchrone.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueFlushEnvoie au client l'ensemble de la sortie actuellement en mémoire tampon.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePicsAjoute un en-tête PICS-Label HTTP au flux de sortie.
Méthode publiqueRedirect(String)Redirige une requête vers une nouvelle URL en spécifiant celle-ci.
Méthode publiqueRedirect(String, Boolean)Redirige un client vers une nouvelle URL. Spécifie la nouvelle URL et indique si l'exécution de la page en cours doit s'arrêter.
Méthode publiqueRedirectPermanent(String)Exécute une redirection permanente de l'URL demandée vers l'URL spécifiée.
Méthode publiqueRedirectPermanent(String, Boolean)Exécute une redirection permanente de l'URL demandée vers l'URL spécifiée, et permet de compléter la réponse.
Méthode publiqueRedirectToRoute(Object)Redirige une requête vers une nouvelle URL à l'aide de valeurs de paramètres d'itinéraires.
Méthode publiqueRedirectToRoute(RouteValueDictionary)Redirige une requête vers une nouvelle URL à l'aide de valeurs de paramètres d'itinéraires.
Méthode publiqueRedirectToRoute(String)Redirige une requête vers une nouvelle URL à l'aide d'un nom d'itinéraire.
Méthode publiqueRedirectToRoute(String, Object)Redirige une requête vers une nouvelle URL en utilisant des valeurs de paramètres d'itinéraires et un nom d'itinéraire.
Méthode publiqueRedirectToRoute(String, RouteValueDictionary)Redirige une requête vers une nouvelle URL en utilisant des valeurs de paramètres d'itinéraires et un nom d'itinéraire.
Méthode publiqueRedirectToRoutePermanent(Object)Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL à l'aide de valeurs de paramètres d'itinéraires.
Méthode publiqueRedirectToRoutePermanent(RouteValueDictionary)Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL à l'aide de valeurs de paramètres d'itinéraires.
Méthode publiqueRedirectToRoutePermanent(String)Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL à l'aide d'un nom d'itinéraire.
Méthode publiqueRedirectToRoutePermanent(String, Object)Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL en utilisant les valeurs de paramètres d'itinéraires et le nom d'itinéraire qui correspondent à la nouvelle URL.
Méthode publiqueRedirectToRoutePermanent(String, RouteValueDictionary)Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL en utilisant des valeurs de paramètres d'itinéraires et un nom d'itinéraire.
Méthode publiqueMembre statiqueRemoveOutputCacheItem(String)Supprime du cache tous les éléments associés au fournisseur de caches de sortie par défaut. Cette méthode est statique.
Méthode publiqueMembre statiqueRemoveOutputCacheItem(String, String)Utilise le fournisseur de caches de sortie spécifié pour supprimer tous les éléments de cache de sortie associés au chemin d'accès spécifié.
Méthode publiqueSetCookieInfrastructure. Met à jour un cookie dans la collection de cookies.
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueTransmitFile(String)Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP sans le placer en mémoire tampon.
Méthode publiqueTransmitFile(String, Int64, Int64)Écrit la partie spécifiée d'un fichier directement dans un flux de sortie de réponse HTTP sans la placer en mémoire tampon.
Méthode publiqueWrite(Char)Écrit un caractère dans un flux de sortie de réponse HTTP.
Méthode publiqueWrite(Object)Écrit Object dans un flux de réponse HTTP.
Méthode publiqueWrite(String)Écrit une chaîne dans un flux de sortie de réponse HTTP.
Méthode publiqueWrite(Char[], Int32, Int32)Écrit un tableau de caractères dans un flux de sortie de réponse HTTP.
Méthode publiqueWriteFile(String)Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de fichier.
Méthode publiqueWriteFile(String, Boolean)Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de mémoire.
Méthode publiqueWriteFile(IntPtr, Int64, Int64)Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.
Méthode publiqueWriteFile(String, Int64, Int64)Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.
Méthode publiqueWriteSubstitutionAutorise l'insertion de blocs de substitution de réponse dans la réponse ; cette technique permet la génération dynamique de régions de réponse spécifiées pour les réponses mises en cache de sortie.
Début

Les méthodes et les propriétés de la classe HttpResponse sont exposées par le biais de la propriété Response des classes HttpApplication, HttpContext, Page et UserControl.

Les méthodes suivantes de la classe HttpResponse sont prises en charge uniquement dans les scénarios de publication (postback), non pas dans les scénarios de publication asynchrone :

La mise à jour de page partielle est activée lorsque vous utilisez des contrôles UpdatePanel pour mettre à jour des régions sélectionnées d'une page au lieu de mettre à jour la page entière au moyen d'une publication (postback). Pour plus d’informations, consultez UpdatePanel Control Overview et Partial-Page Rendering Overview.

TopicLocation
Comment : passer des valeurs entre des pages Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : passer des valeurs entre des pages Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : passer des valeurs entre des pages Web ASP.NETGénération d'applications Web ASP.NET

Dans l'exemple de code suivant, lorsque la page est demandée, trois rectangles se chevauchant sont dessinés. Le code commence par attribuer à la propriété ContentType la valeur image/jpeg, afin que la page entière soit rendue en tant qu'image au format JPEG. Le code appelle ensuite la méthode Clear pour garantir qu'aucun contenu étranger n'est envoyé avec cette réponse. Ensuite, le code attribue à la propriété BufferOutput la valeur true, afin que la page soit complètement traitée avant d'être envoyée au client demandeur. Deux objets utilisés pour dessiner les rectangles sont alors créés : un objet Bitmap et un objet Graphics. Les variables créées dans la page servent de coordonnées pour dessiner les rectangles et une chaîne qui s'affiche à l'intérieur du plus grand.

Lorsque les trois rectangles et la chaîne qui figure en leur sein sont dessinés, le Bitmap est enregistré dans l'objet Stream associé à la propriété OutputStream, et son format a la valeur JPEG. Le code appelle les méthodes Dispose et Dispose pour libérer les ressources utilisées par les deux objets de dessin. Enfin, le code appelle la méthode Flush pour envoyer la réponse mise en mémoire tampon au client demandeur.

RemarqueRemarque

Dans le code, l'objet HttpResponse est référencé par le mot clé Response. Par exemple, Response.Clear() fait référence à la méthode HttpResponse.Clear. La classe Page a une propriété nommée Response qui expose l'instance actuelle de HttpResponse.


<%@ Page Language="C#" %>
<%@ import Namespace="System.Drawing" %>
<%@ import Namespace="System.Drawing.Imaging" %>
<%@ import Namespace="System.Drawing.Drawing2D" %>

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

    private void Page_Load(object sender, EventArgs e)
    {
        // Set the page's content type to JPEG files
        // and clears all content output from the buffer stream.
        Response.ContentType = "image/jpeg";
        Response.Clear();

        // Buffer response so that page is sent
        // after processing is complete.
        Response.BufferOutput = true;

        // Create a font style.
        Font rectangleFont = new Font(
            "Arial", 10, FontStyle.Bold);

        // Create integer variables.
        int height = 100;
        int width = 200;

        // Create a random number generator and create
        // variable values based on it.
        Random r = new Random();
        int x = r.Next(75);
        int a = r.Next(155);
        int x1 = r.Next(100);

        // Create a bitmap and use it to create a
        // Graphics object.
        Bitmap bmp = new Bitmap(
            width, height, PixelFormat.Format24bppRgb);
        Graphics g = Graphics.FromImage(bmp);

        g.SmoothingMode = SmoothingMode.AntiAlias;
        g.Clear(Color.LightGray);

        // Use the Graphics object to draw three rectangles.
        g.DrawRectangle(Pens.White, 1, 1, width-3, height-3);
        g.DrawRectangle(Pens.Aquamarine, 2, 2, width-3, height-3);
        g.DrawRectangle(Pens.Black, 0, 0, width, height);

        // Use the Graphics object to write a string
        // on the rectangles.
        g.DrawString(
            "ASP.NET Samples", rectangleFont,
            SystemBrushes.WindowText, new PointF(10, 40));

        // Apply color to two of the rectangles.
        g.FillRectangle(
            new SolidBrush(
                Color.FromArgb(a, 255, 128, 255)),
            x, 20, 100, 50);

        g.FillRectangle(
            new LinearGradientBrush(
                new Point(x, 10),
                new Point(x1 + 75, 50 + 30),
                Color.FromArgb(128, 0, 0, 128),
                Color.FromArgb(255, 255, 255, 240)),
            x1, 50, 75, 30);

        // Save the bitmap to the response stream and
        // convert it to JPEG format.
        bmp.Save(Response.OutputStream, ImageFormat.Jpeg);

        // Release memory used by the Graphics object
        // and the bitmap.
        g.Dispose();
        bmp.Dispose();

        // Send the output to the client.
        Response.Flush();
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>


.NET Framework

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

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft