HttpResponse Classe

Définition

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

public ref class HttpResponse sealed
public sealed class HttpResponse
type HttpResponse = class
Public NotInheritable Class HttpResponse
Héritage
HttpResponse

Exemples

L’exemple suivant dessine trois rectangles qui se chevauchent lorsque la page est demandée. Le code commence par définir la ContentType propriété sur image/jpeg, afin que la page entière soit affichée sous forme d’image JPEG. Le code appelle ensuite la Clear méthode pour s’assurer qu’aucun contenu superflu n’est envoyé avec cette réponse. Ensuite, le code définit la BufferOutput propriété sur true afin que la page soit entièrement traitée avant d’être envoyée au client demandeur. Deux objets utilisés pour dessiner les rectangles sont ensuite créés : un Bitmap et un Graphics objet. Les variables créées dans la page sont utilisées comme coordonnées pour dessiner les rectangles et une chaîne qui apparaît à l’intérieur du plus grand rectangle.

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

Notes

Dans le code, l’objet HttpResponse est référencé par le mot clé Response. Par exemple, Response.Clear() fait référence à la HttpResponse.Clear méthode . La Page classe a une propriété nommée Response qui expose le instance actuel 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)
    {
// <snippet2>
        // 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;
// </snippet2>
    
        // 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);

// <snippet3>    
        // 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();
// </snippet3>
    }

</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>
<%@ Page Language="VB" %>
<%@ 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 Sub Page_Load(sender As Object, e As EventArgs)
' <snippet2>
      ' 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
' </snippet2>
      
      ' Create a font style.
      Dim rectangleFont As New Font( _
          "Arial", 10, FontStyle.Bold)
      
      ' Create integer variables.
      Dim height As Integer = 100
      Dim width As Integer = 200
      
      ' Create a random number generator and create
      ' variable values based on it.
      Dim r As New Random()
      Dim x As Integer = r.Next(75)
      Dim a As Integer = r.Next(155)
      Dim x1 As Integer = r.Next(100)
      
      ' Create a bitmap and use it to create a
      ' Graphics object.
      Dim bmp As New Bitmap( _
          width, height, PixelFormat.Format24bppRgb)
      Dim g As Graphics = 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)

' <snippet3>      
      ' 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()
' </snippet3>
   End Sub 'Page_Load

</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>

Remarques

Les méthodes et les propriétés de la HttpResponse classe sont exposées via la Response propriété des HttpApplicationclasses , HttpContext, Pageet UserControl .

Les méthodes suivantes de la HttpResponse classe sont prises en charge uniquement dans les scénarios de post-retour et non dans les scénarios de post-retour asynchrone :

Les mises à jour partielles de page sont activées lorsque vous utilisez UpdatePanel des contrôles pour mettre à jour les régions sélectionnées d’une page au lieu de mettre à jour l’ensemble de la page avec une publication en arrière. Pour plus d’informations, consultez Vue d’ensemble du contrôle UpdatePanel et Vue d’ensemble du rendu de page partielle.

Constructeurs

HttpResponse(TextWriter)

Initialise une nouvelle instance de la classe HttpResponse.

Propriétés

Buffer

Obtient ou définit une valeur indiquant 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.

BufferOutput

Obtient ou définit une valeur indiquant 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.

Cache

Obtient la stratégie de mise en cache d’une page web (délai d’expiration, paramètres de confidentialité, clauses diverses).

CacheControl

Obtient ou définit l'en-tête HTTP Cache-Control qui correspond à l'une des valeurs d'énumérationHttpCacheability

Charset

Obtient ou définit le jeu de caractères HTTP du flux de sortie.

ClientDisconnectedToken

Obtient un objet CancellationToken dépassé lors de la déconnexion du client.

ContentEncoding

Obtient ou définit le jeu de caractères HTTP du flux de sortie.

ContentType

Obtient ou définit le type MIME HTTP du flux de sortie.

Cookies

Obtient la collection de cookies constituant la réponse.

Expires

Obtient 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 d'ASP.

ExpiresAbsolute

Obtient ou définit la date et l'heure absolues auxquelles supprimer des informations du cache. ExpiresAbsolute est fourni pour des raisons de compatibilité avec les versions précédentes d'ASP.

Filter

Obtient ou définit un objet de filtre de retour à la ligne utilisé pour modifier le corps d'une entité HTTP avant la transmission.

HeaderEncoding

Obtient ou définit un objet Encoding qui représente l'encodage du flux de sortie d'en-tête actuel.

Headers

Obtient la collection d'en-têtes de réponse.

HeadersWritten

Obtient une valeur indiquant si les en-têtes de réponse ont été écrits.

IsClientConnected

Obtient une valeur indiquant si le client est encore connecté au serveur.

IsRequestBeingRedirected

Obtient une valeur booléenne qui indique si le client est transféré vers un nouvel emplacement.

Output

Permet la sortie du texte dans le flux de réponse HTTP sortant.

OutputStream

Permet une sortie binaire vers le corps du contenu HTTP sortant.

RedirectLocation

Obtient ou définit la valeur de l'en-tête HTTP Location.

Status

Définit la ligne Status retournée vers le client.

StatusCode

Obtient ou définit le code d'état HTTP du résultat retourné au client.

StatusDescription

Obtient ou définit la chaîne d'état HTTP du résultat retourné au client.

SubStatusCode

Obtient ou définit une valeur qui qualifie le code d'état de la réponse.

SupportsAsyncFlush

Obtient une valeur qui indique si la connexion prend en charge les opérations de vidage asynchrones.

SuppressContent

Obtient ou définit une valeur indiquant si le contenu HTTP doit être envoyé au client.

SuppressDefaultCacheControlHeader

Obtient ou définit une valeur indiquant s’il faut supprimer l’en-tête par défaut Cache Control: private de la réponse HTTP actuelle.

SuppressFormsAuthenticationRedirect

Obtient ou définit une valeur qui indique si la redirection d'authentification par formulaire à la page de connexion doit être supprimée.

TrySkipIisCustomErrors

Obtient ou définit une valeur qui spécifie si les erreurs personnalisées IIS 7.0 sont désactivées.

Méthodes

AddCacheDependency(CacheDependency[])

Associe 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 sont modifiées.

AddCacheItemDependencies(ArrayList)

Rend la validité d'une réponse mise en cache dépendante d'autres éléments présents dans le cache.

AddCacheItemDependencies(String[])

Rend la validité d'un élément mis en cache dépendante d'un autre élément du cache.

AddCacheItemDependency(String)

Rend la validité d'une réponse mise en cache dépendante d'un autre élément du cache.

AddFileDependencies(ArrayList)

Ajoute un groupe de noms de fichier à la collection de noms de fichier dont dépend la réponse actuelle.

AddFileDependencies(String[])

Ajoute un tableau de noms de fichiers à la collection de noms de fichiers dont dépend la réponse actuelle.

AddFileDependency(String)

Ajoute un seul nom de fichier à la collection de noms de fichiers dont dépend la réponse actuelle.

AddHeader(String, String)

Ajoute un en-tête HTTP au flux de sortie. AddHeader(String, String) est fourni pour des raisons de compatibilité avec les versions précédentes d'ASP.

AddOnSendingHeaders(Action<HttpContext>)

Inscrit un rappel que le runtime ASP.NET appelle immédiatement avant l'envoi des en-têtes de réponse correspondant à cette requête.

AppendCookie(HttpCookie)

Ajoute un cookie HTTP à la collection de cookies intrinsèque.

AppendHeader(String, String)

Ajoute un en-tête HTTP au flux de sortie.

AppendToLog(String)

Ajoute des informations personnalisées au fichier journal IIS (Internet Information Services).

ApplyAppPathModifier(String)

Ajoute 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(String) retourne le chemin d'accès virtuel d'origine.

BeginFlush(AsyncCallback, Object)

Envoie la réponse actuellement en mémoire tampon au client.

BinaryWrite(Byte[])

Écrit une chaîne de caractères binaires dans le flux de sortie HTTP.

Clear()

Efface le contenu de sortie du flux de la mémoire tampon.

ClearContent()

Efface le contenu de sortie du flux de la mémoire tampon.

ClearHeaders()

Efface tous les en-têtes dans le flux de la mémoire tampon.

Close()

Ferme la connexion du socket à un client.

DisableKernelCache()

Désactive la mise en cache de noyau pour la réponse en cours.

DisableUserCache()

Désactive la mise en cache en mode utilisateur IIS pour cette réponse.

End()

Envoie l'ensemble de la sortie actuellement en mémoire tampon au client, arrête l'exécution de la page et déclenche l'événement EndRequest.

EndFlush(IAsyncResult)

Termine une opération de vidage asynchrone.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Flush()

Envoie au client l'ensemble de la sortie actuellement en mémoire tampon.

FlushAsync()

Envoie de façon asynchrone l’ensemble de la sortie actuellement en mémoire tampon au client.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
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)
Pics(String)

Ajoute un en-tête PICS-Label HTTP au flux de sortie.

PushPromise(String)

Prend en charge les applications qui envoient des promesses push aux clients HTTP 2.0. Pour plus d’informations, consultez HTTP/2 Specification Section 8.2 : Server Push.

PushPromise(String, String, NameValueCollection)

Prend en charge les applications qui envoient des promesses push aux clients HTTP 2.0. Pour plus d’informations, consultez HTTP/2 Specification Section 8.2 : Server Push.

Redirect(String)

Redirige une requête vers une nouvelle URL en spécifiant celle-ci.

Redirect(String, Boolean)

Redirige un client vers une nouvelle URL. Spécifie la nouvelle URL et indique si l'exécution de la page active doit s'arrêter.

RedirectPermanent(String)

Exécute une redirection permanente de l'URL demandée vers l'URL spécifiée.

RedirectPermanent(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.

RedirectToRoute(Object)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

RedirectToRoute(RouteValueDictionary)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

RedirectToRoute(String)

Redirige une requête vers une nouvelle URL en utilisant un nom d'itinéraire.

RedirectToRoute(String, Object)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

RedirectToRoute(String, RouteValueDictionary)

Redirige une requête vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

RedirectToRoutePermanent(Object)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

RedirectToRoutePermanent(RouteValueDictionary)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire.

RedirectToRoutePermanent(String)

Effectue une redirection permanente à partir d'une URL demandée vers une nouvelle URL en utilisant un nom d'itinéraire.

RedirectToRoutePermanent(String, Object)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et le nom d'itinéraire qui correspondent à la nouvelle URL.

RedirectToRoutePermanent(String, RouteValueDictionary)

Effectue une redirection permanente d'une URL demandée vers une nouvelle URL en utilisant les valeurs des paramètres d'itinéraire et un nom d'itinéraire.

RemoveOutputCacheItem(String)

Supprime du cache tous les éléments associés au fournisseur de caches de sortie par défaut. Cette méthode est statique.

RemoveOutputCacheItem(String, String)

Utilise le fournisseur de cache de sortie spécifié pour supprimer tous les éléments de cache de sortie associés au chemin d’accès spécifié.

SetCookie(HttpCookie)

Dans la mesure où la méthode HttpResponse.SetCookie est exclusivement réservée à un usage interne, vous ne devez pas l’appeler dans votre code. Appelez plutôt la méthode HttpResponse.Cookies.Set, comme le montre l’exemple suivant.
Met à jour un cookie existant dans la collection de cookies.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TransmitFile(String)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP sans le placer en mémoire tampon.

TransmitFile(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.

Write(Char)

Écrit un caractère dans un flux de sortie de réponse HTTP.

Write(Char[], Int32, Int32)

Écrit un tableau de caractères dans un flux de sortie de réponse HTTP.

Write(Object)

Écrit Object dans un flux de réponse HTTP.

Write(String)

Écrit une chaîne dans un flux de sortie de réponse HTTP.

WriteFile(IntPtr, Int64, Int64)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.

WriteFile(String)

Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP comme un bloc de fichier.

WriteFile(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.

WriteFile(String, Int64, Int64)

Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP.

WriteSubstitution(HttpResponseSubstitutionCallback)

Autorise 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 de sortie mises en cache.

S’applique à