HttpResponse 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 les informations de réponse HTTP à partir d’une opération de ASP.NET.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Héritage: Object
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 la forme d’une image JPEG. Le code appelle ensuite la Clear méthode pour s’assurer qu’aucun contenu supplémentaire 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 dans le plus grand rectangle.

Lorsque les trois rectangles et la chaîne qui s’affichent à l’intérieur d’eux sont dessinés, il Bitmap est enregistré dans l’objet Stream associé à la OutputStream propriété et son format est défini sur JPEG. Le code appelle les méthodes et Dispose les Dispose méthodes 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.

Note

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 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)
    {
// <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 par le biais de la Response propriété des classes, et HttpContext Page UserControl des HttpApplicationpropriétés.

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

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 toute la page avec une publication. Pour plus d’informations, consultez UpdatePanel Control Overview et Partial-Page Rendering Overview.

Constructeurs

Nom	Description
HttpResponse(TextWriter)	Initialise une nouvelle instance de la classe HttpResponse.

Propriétés

Nom	Description
Buffer	Obtient ou définit une valeur indiquant s’il faut mettre en mémoire tampon la sortie et l’envoyer une fois la réponse complète terminée.
BufferOutput	Obtient ou définit une valeur indiquant s’il faut mettre en mémoire tampon la sortie et l’envoyer une fois la page terminée terminée.
Cache	Obtient la stratégie de mise en cache (par exemple, l’heure d’expiration, les paramètres de confidentialité et les clauses de variation) d’une page Web.
CacheControl	Obtient ou définit l’en-tête `Cache-Control` HTTP qui correspond à l’une HttpCacheability des valeurs d’énumération.
Charset	Obtient ou définit le jeu de caractères HTTP du flux de sortie.
ClientDisconnectedToken	Obtient un CancellationToken objet qui est triplé lorsque le client se déconnecte.
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 de réponse.
Expires	Obtient ou définit le nombre de minutes avant l’expiration d’une page mise en cache sur un navigateur. Si l’utilisateur retourne à la même page avant son expiration, la version mise en cache s’affiche. Expires est fourni pour la compatibilité avec les versions antérieures d’ASP.
ExpiresAbsolute	Obtient ou définit la date et l’heure absolues auxquelles supprimer les informations mises en cache du cache. ExpiresAbsolute est fourni pour la compatibilité avec les versions antérieures d’ASP.
Filter	Obtient ou définit un objet de filtre d’habillage utilisé pour modifier le corps de l’entité HTTP avant la transmission.
HeaderEncoding	Obtient ou définit un Encoding objet 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 toujours connecté au serveur.
IsRequestBeingRedirected	Obtient une valeur booléenne indiquant si le client est transféré vers un nouvel emplacement.
Output	Active la sortie du texte dans le flux de réponse HTTP sortant.
OutputStream	Active la sortie binaire dans le corps de contenu HTTP sortant.
RedirectLocation	Obtient ou définit la valeur de l’en-tête HTTP `Location` .
Status	Définit la `Status` ligne retournée au client.
StatusCode	Obtient ou définit le code d’état HTTP de la sortie retournée au client.
StatusDescription	Obtient ou définit la chaîne d’état HTTP de la sortie retournée 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 s’il faut envoyer du contenu HTTP 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 spécifie si la redirection d’authentification par formulaire vers 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

Nom	Description
AddCacheDependency(CacheDependency[])	Associe un ensemble de dépendances de cache à la réponse pour faciliter l’invalidation de la réponse si elle est stockée dans le cache de sortie et que les dépendances spécifiées changent.
AddCacheItemDependencies(ArrayList)	Rend la validité d’une réponse mise en cache dépendante d’autres éléments du cache.
AddCacheItemDependencies(String[])	Rend la validité d’un élément mis en cache dépendant d’un autre élément dans le cache.
AddCacheItemDependency(String)	Rend la validité d’une réponse mise en cache dépendante d’un autre élément dans le cache.
AddFileDependencies(ArrayList)	Ajoute un groupe de noms de fichiers à la collection de noms de fichiers sur lesquels la réponse actuelle dépend.
AddFileDependencies(String[])	Ajoute un tableau de noms de fichiers à la collection de noms de fichiers sur lesquels la réponse actuelle dépend.
AddFileDependency(String)	Ajoute un nom de fichier unique à la collection de noms de fichiers sur lesquels 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 la compatibilité avec les versions antérieures d’ASP.
AddOnSendingHeaders(Action<HttpContext>)	Inscrit un rappel que le runtime ASP.NET appelle immédiatement avant que les en-têtes de réponse ne soient envoyés pour 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 de journal 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 Cookieless l’état de session et retourne le chemin combiné. Si Cookieless l’état de session n’est pas utilisé, ApplyAppPathModifier(String) retourne le chemin d’accès virtuel d’origine.
BeginFlush(AsyncCallback, Object)	Envoie la réponse actuellement mise en mémoire tampon au client.
BinaryWrite(Byte[])	Écrit une chaîne de caractères binaires dans le flux de sortie HTTP.
Clear()	Efface toutes les sorties de contenu du flux de mémoire tampon.
ClearContent()	Efface toutes les sorties de contenu du flux de mémoire tampon.
ClearHeaders()	Efface tous les en-têtes du flux de mémoire tampon.
Close()	Ferme la connexion de socket à un client.
DisableKernelCache()	Désactive la mise en cache du noyau pour la réponse actuelle.
DisableUserCache()	Désactive la mise en cache en mode utilisateur IIS pour cette réponse.
End()	Envoie toutes les sorties actuellement mises 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 toutes les sorties actuellement mises en mémoire tampon au client.
FlushAsync()	Envoie de façon asynchrone toutes les sorties mises en mémoire tampon au client.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Pics(String)	Ajoute un en-tête HTTP `PICS-Label` au flux de sortie.
PushPromise(String, String, NameValueCollection)	Prend en charge les applications qui envoient des promesses push aux clients HTTP 2.0. Pour plus d’informations, consultez la section de spécification HTTP/2 8.2 : Push du serveur.
PushPromise(String)	Prend en charge les applications qui envoient des promesses push aux clients HTTP 2.0. Pour plus d’informations, consultez la section de spécification HTTP/2 8.2 : Push du serveur.
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 se terminer.
Redirect(String)	Redirige une requête vers une nouvelle URL et spécifie la nouvelle URL.
RedirectPermanent(String, Boolean)	Effectue une redirection permanente de l’URL demandée vers l’URL spécifiée et fournit la possibilité de terminer la réponse.
RedirectPermanent(String)	Effectue une redirection permanente de l’URL demandée vers l’URL spécifiée.
RedirectToRoute(Object)	Redirige une requête vers une nouvelle URL à l’aide de valeurs de paramètre de routage.
RedirectToRoute(RouteValueDictionary)	Redirige une requête vers une nouvelle URL à l’aide de valeurs de paramètre de routage.
RedirectToRoute(String, Object)	Redirige une requête vers une nouvelle URL à l’aide de valeurs de paramètre d’itinéraire et d’un nom d’itinéraire.
RedirectToRoute(String, RouteValueDictionary)	Redirige une requête vers une nouvelle URL à l’aide de valeurs de paramètre d’itinéraire et d’un nom d’itinéraire.
RedirectToRoute(String)	Redirige une requête vers une nouvelle URL à l’aide d’un nom d’itinéraire.
RedirectToRoutePermanent(Object)	Effectue une redirection permanente à partir d’une URL demandée vers une nouvelle URL à l’aide de valeurs de paramètre de routage.
RedirectToRoutePermanent(RouteValueDictionary)	Effectue une redirection permanente à partir d’une URL demandée vers une nouvelle URL à l’aide de valeurs de paramètre de routage.
RedirectToRoutePermanent(String, Object)	Effectue une redirection permanente à partir d’une URL demandée vers une nouvelle URL à l’aide des valeurs des paramètres de routage et du nom de l’itinéraire correspondant à la nouvelle URL.
RedirectToRoutePermanent(String, RouteValueDictionary)	Effectue une redirection permanente à partir d’une URL demandée vers une nouvelle URL à l’aide de valeurs de paramètre de routage et d’un nom d’itinéraire.
RedirectToRoutePermanent(String)	Effectue une redirection permanente à partir d’une URL demandée vers une nouvelle URL à l’aide d’un nom de route.
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 spécifié.
RemoveOutputCacheItem(String)	Supprime du cache tous les éléments mis en cache associés au fournisseur de cache de sortie par défaut. Cette méthode est statique.
SetCookie(HttpCookie)	Étant donné que la méthode HttpResponse.SetCookie est destinée à une utilisation interne uniquement, vous ne devez pas l’appeler dans votre code. Au lieu de cela, vous pouvez appeler la méthode HttpResponse.Cookies.Set , comme l’illustre 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, Int64, Int64)	Écrit la partie spécifiée d’un fichier directement dans un flux de sortie de réponse HTTP sans la mettre en mémoire tampon.
TransmitFile(String)	Écrit le fichier spécifié directement dans un flux de sortie de réponse HTTP, sans le mettre 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 un Object 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, Boolean)	Écrit le contenu du fichier spécifié directement dans un flux de sortie de réponse HTTP en tant que bloc de mémoire.
WriteFile(String, 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 en tant que bloc de fichiers.
WriteSubstitution(HttpResponseSubstitutionCallback)	Permet l’insertion des blocs de substitution de réponse dans la réponse, ce qui permet la génération dynamique de régions de réponse spécifiées pour les réponses mises en cache de sortie.

S’applique à

Commentaires

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