Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HttpResponse, classe

 

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

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

System.Object
  System.Web.HttpResponse

public sealed class HttpResponse

NomDescription
System_CAPS_pubmethodHttpResponse(TextWriter)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe HttpResponse.

NomDescription
System_CAPS_pubpropertyBuffer

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.

System_CAPS_pubpropertyBufferOutput

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.

System_CAPS_pubpropertyCache

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

System_CAPS_pubpropertyCacheControl

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

System_CAPS_pubpropertyCharset

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

System_CAPS_pubpropertyClientDisconnectedToken

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

System_CAPS_pubpropertyContentEncoding

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

System_CAPS_pubpropertyContentType

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

System_CAPS_pubpropertyCookies

Obtient la collection de cookies constituant la réponse.

System_CAPS_pubpropertyExpires

Obtient ou définit le nombre de minutes avant l'expiration d'une page mise en cache dans 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.

System_CAPS_pubpropertyExpiresAbsolute

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.

System_CAPS_pubpropertyFilter

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

System_CAPS_pubpropertyHeaderEncoding

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

System_CAPS_pubpropertyHeaders

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

System_CAPS_pubpropertyHeadersWritten

[Pris en charge dans .NET Framework 4.5.2 et versions ultérieures]

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

System_CAPS_pubpropertyIsClientConnected

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

System_CAPS_pubpropertyIsRequestBeingRedirected

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

System_CAPS_pubpropertyOutput

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

System_CAPS_pubpropertyOutputStream

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

System_CAPS_pubpropertyRedirectLocation

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

System_CAPS_pubpropertyStatus

Définit la ligne Status retournée au client.

System_CAPS_pubpropertyStatusCode

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

System_CAPS_pubpropertyStatusDescription

Obtient ou définit la chaîne d'état HTTP de la sortie retournée au client.

System_CAPS_pubpropertySubStatusCode

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

System_CAPS_pubpropertySupportsAsyncFlush

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

System_CAPS_pubpropertySuppressContent

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

System_CAPS_pubpropertySuppressDefaultCacheControlHeader

[Pris en charge dans .NET Framework 4.5.2 et versions ultérieures]

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.

System_CAPS_pubpropertySuppressFormsAuthenticationRedirect

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

System_CAPS_pubpropertyTrySkipIisCustomErrors

Obtient ou définit une valeur qui indique si les erreurs personnalisées IIS 7,0 sont désactivées.

NomDescription
System_CAPS_pubmethodAddCacheDependency(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.

System_CAPS_pubmethodAddCacheItemDependencies(ArrayList)

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

System_CAPS_pubmethodAddCacheItemDependencies(String[])

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

System_CAPS_pubmethodAddCacheItemDependency(String)

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

System_CAPS_pubmethodAddFileDependencies(ArrayList)

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

System_CAPS_pubmethodAddFileDependencies(String[])

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

System_CAPS_pubmethodAddFileDependency(String)

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

System_CAPS_pubmethodAddHeader(String, String)

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

System_CAPS_pubmethodAddOnSendingHeaders(Action<HttpContext>)

[Pris en charge dans .NET Framework 4.5.2 et ultérieur]

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.

System_CAPS_pubmethodAppendCookie(HttpCookie)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Ajoute un cookie HTTP à la collection de cookies intrinsèque.

System_CAPS_pubmethodAppendHeader(String, String)

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

System_CAPS_pubmethodAppendToLog(String)

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

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

System_CAPS_pubmethodBeginFlush(AsyncCallback, Object)

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

System_CAPS_pubmethodBinaryWrite(Byte[])

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

System_CAPS_pubmethodClear()

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

System_CAPS_pubmethodClearContent()

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

System_CAPS_pubmethodClearHeaders()

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

System_CAPS_pubmethodClose()

Ferme la connexion du socket à un client.

System_CAPS_pubmethodDisableKernelCache()

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

System_CAPS_pubmethodDisableUserCache()

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

System_CAPS_pubmethodEnd()

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.

System_CAPS_pubmethodEndFlush(IAsyncResult)

Termine une opération de vidage asynchrone.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodFlush()

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

System_CAPS_pubmethodFlushAsync()

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

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodPics(String)

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

System_CAPS_pubmethodPushPromise(String)

Cette API permet de prendre en charge les applications qui envoient des promesses push aux clients HTTP 2.0. Vous trouverez plus de détails concernant les push de serveur Http2 à HTTP/2 Specification Section 8.2: Server Push.

System_CAPS_pubmethodPushPromise(String, String, NameValueCollection)

Cette API permet de prendre en charge les applications qui envoient des promesses push aux clients HTTP 2.0. Vous trouverez plus de détails concernant les push de serveur Http2 à HTTP/2 Specification Section 8.2: Server Push.

System_CAPS_pubmethodRedirect(String)

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

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

System_CAPS_pubmethodRedirectPermanent(String)

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

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

System_CAPS_pubmethodRedirectToRoute(Object)

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

System_CAPS_pubmethodRedirectToRoute(RouteValueDictionary)

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

System_CAPS_pubmethodRedirectToRoute(String)

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

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

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

System_CAPS_pubmethodRedirectToRoutePermanent(Object)

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

System_CAPS_pubmethodRedirectToRoutePermanent(RouteValueDictionary)

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

System_CAPS_pubmethodRedirectToRoutePermanent(String)

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

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

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

System_CAPS_pubmethodSystem_CAPS_staticRemoveOutputCacheItem(String)

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

System_CAPS_pubmethodSystem_CAPS_staticRemoveOutputCacheItem(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é.

System_CAPS_pubmethodSetCookie(HttpCookie)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Met à jour un cookie existant dans la collection de cookies.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodTransmitFile(String)

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

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

System_CAPS_pubmethodWrite(Char)

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

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

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

System_CAPS_pubmethodWrite(Object)

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

System_CAPS_pubmethodWrite(String)

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

System_CAPS_pubmethodWriteFile(IntPtr, Int64, Int64)

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

System_CAPS_pubmethodWriteFile(String)

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

System_CAPS_pubmethodWriteFile(String, Boolean)

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

System_CAPS_pubmethodWriteFile(String, Int64, Int64)

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

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

Les méthodes et propriétés de la HttpResponse classe sont exposées via la Response propriété de la HttpApplication, HttpContext, Page, et UserControl classes.

Les méthodes suivantes de la HttpResponse classe sont pris en charge uniquement dans les scénarios de publication et non dans la publication asynchrone sauvegarder les scénarios :

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

L'exemple suivant dessine trois rectangles qui se chevauchent lorsque la page est demandée. Le code commence par définir le ContentType propriété image/JPEG, afin que la page entière soit rendue sous forme d'image JPEG. Le code appelle ensuite la Clear pour s'assurer qu'aucun contenu étranger n'est envoyé avec cette réponse. Ensuite, le code définit le BufferOutput propriété sur true afin que la page soit complètement traitée avant d'être envoyé au client demandeur. Deux objets utilisés pour dessiner les rectangles sont alors créés : un Bitmap et un Graphics objet. Les variables créées dans la page servent de coordonnées pour dessiner des rectangles et une chaîne qui s'affiche dans le plus grand rectangle.

Lorsque les trois rectangles et la chaîne qui figure en leur sein sont dessinés, le Bitmap est enregistré dans le Stream objet auquel est associé le OutputStream propriété et son format est défini au format JPEG. Le code appelle la Dispose et 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.

System_CAPS_noteRemarque

Dans le code, le HttpResponse objet 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)
    {
        // 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
Disponible depuis 1.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher: