HttpResponse Klass

Definition

Namnområde:: System.Web

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Kapslar in HTTP-svarsinformation från en ASP.NET åtgärd.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Arv: Object
HttpResponse

Exempel

I följande exempel ritas tre överlappande rektanglar när sidan begärs. Koden börjar med att ställa in ContentType egenskapen på bild/jpeg, så att hela sidan återges som en JPEG-bild. Koden anropar Clear sedan metoden för att säkerställa att inget överflödigt innehåll skickas med det här svaret. Sedan anger BufferOutput koden egenskapen till true så att sidan bearbetas helt innan den skickas till den begärande klienten. Två objekt som används för att rita rektanglarna skapas sedan: ett Bitmap och ett Graphics objekt. Variablerna som skapas på sidan används som koordinater för att rita rektanglar och en sträng som visas i den största rektangeln.

När de tre rektanglarna och strängen som visas inuti dem ritas Bitmap sparas Stream objektet som är associerat med OutputStream egenskapen och dess format är inställt på JPEG. Koden anropar Dispose metoderna och Dispose för att frigöra de resurser som används av de två ritobjekten. Slutligen anropar Flush koden metoden för att skicka det buffrade svaret till den begärande klienten.

Note

I kod refereras objektet HttpResponse till av nyckelordet Response. Till exempel Response.Clear() refererar till HttpResponse.Clear metoden. Klassen Page har en egenskap med namnet Response som exponerar den aktuella instansen av 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>

Kommentarer

Metoderna och egenskaperna för HttpResponse klassen exponeras via Response egenskapen för klasserna HttpApplication, HttpContext, Pageoch UserControl .

Följande metoder i HttpResponse klassen stöds endast i scenarier efter bakåt och inte i asynkrona scenarier efter rygg:

Partiella siduppdateringar aktiveras när du använder UpdatePanel kontroller för att uppdatera valda regioner på en sida i stället för att uppdatera hela sidan med ett inlägg tillbaka. Mer information finns i Översikt över UpdatePanel-kontroll och Partial-Page renderingsöversikt.

Konstruktorer

Name	Description
HttpResponse(TextWriter)	Initierar en ny instans av HttpResponse klassen.

Egenskaper

Name	Description
Buffer	Hämtar eller anger ett värde som anger om utdata ska bufferas och skickas när det fullständiga svaret har slutförts.
BufferOutput	Hämtar eller anger ett värde som anger om utdata ska bufferas och skickas när hela sidan har bearbetats.
Cache	Hämtar cachelagringsprincipen (till exempel förfallotid, sekretessinställningar och olika satser) för en webbsida.
CacheControl	Hämtar eller anger `Cache-Control` HTTP-huvudet som matchar ett av uppräkningsvärdena HttpCacheability .
Charset	Hämtar eller anger HTTP-teckenuppsättningen för utdataströmmen.
ClientDisconnectedToken	Hämtar ett CancellationToken objekt som utlöss när klienten kopplas från.
ContentEncoding	Hämtar eller anger HTTP-teckenuppsättningen för utdataströmmen.
ContentType	Hämtar eller anger HTTP MIME-typen för utdataströmmen.
Cookies	Hämtar insamlingen av svarscookie.
Expires	Hämtar eller anger antalet minuter innan en sida som cachelagras i en webbläsare upphör att gälla. Om användaren återgår till samma sida innan den upphör att gälla visas den cachelagrade versionen. Expires tillhandahålls för kompatibilitet med tidigare versioner av ASP.
ExpiresAbsolute	Hämtar eller anger det absoluta datum och den tid då cachelagrad information ska tas bort från cachen. ExpiresAbsolute tillhandahålls för kompatibilitet med tidigare versioner av ASP.
Filter	Hämtar eller anger ett omslutningsfilterobjekt som används för att ändra HTTP-entitetstexten före överföring.
HeaderEncoding	Hämtar eller anger ett Encoding objekt som representerar kodningen för den aktuella huvudutdataströmmen.
Headers	Hämtar samlingen med svarshuvuden.
HeadersWritten	Hämtar ett värde som anger om svarshuvudena har skrivits.
IsClientConnected	Hämtar ett värde som anger om klienten fortfarande är ansluten till servern.
IsRequestBeingRedirected	Hämtar ett booleskt värde som anger om klienten överförs till en ny plats.
Output	Aktiverar utdata från text till den utgående HTTP-svarsströmmen.
OutputStream	Aktiverar binära utdata till utgående HTTP-innehållstext.
RedirectLocation	Hämtar eller anger värdet för HTTP-huvudet `Location` .
Status	Anger den `Status` rad som returneras till klienten.
StatusCode	Hämtar eller anger HTTP-statuskoden för utdata som returneras till klienten.
StatusDescription	Hämtar eller anger HTTP-statussträngen för utdata som returneras till klienten.
SubStatusCode	Hämtar eller anger ett värde som kvalificerar statuskoden för svaret.
SupportsAsyncFlush	Hämtar ett värde som anger om anslutningen stöder asynkrona tömningsåtgärder.
SuppressContent	Hämtar eller anger ett värde som anger om HTTP-innehåll ska skickas till klienten.
SuppressDefaultCacheControlHeader	Hämtar eller anger ett värde som anger om standardrubriken `Cache Control: private` för det aktuella HTTP-svaret ska ignoreras.
SuppressFormsAuthenticationRedirect	Hämtar eller anger ett värde som anger om omdirigering av formulärautentisering till inloggningssidan ska ignoreras.
TrySkipIisCustomErrors	Hämtar eller anger ett värde som anger om anpassade IIS 7.0-fel är inaktiverade.

Metoder

Name	Description
AddCacheDependency(CacheDependency[])	Associerar en uppsättning cacheberoenden med svaret för att underlätta ogiltigheten av svaret om det lagras i utdatacachen och de angivna beroendena ändras.
AddCacheItemDependencies(ArrayList)	Gör giltigheten för ett cachelagrat svar beroende av andra objekt i cacheminnet.
AddCacheItemDependencies(String[])	Gör giltigheten för ett cachelagrat objekt beroende av ett annat objekt i cacheminnet.
AddCacheItemDependency(String)	Gör giltigheten för ett cachelagrat svar beroende av ett annat objekt i cacheminnet.
AddFileDependencies(ArrayList)	Lägger till en grupp med filnamn i samlingen med filnamn som det aktuella svaret är beroende av.
AddFileDependencies(String[])	Lägger till en matris med filnamn i samlingen med filnamn som det aktuella svaret är beroende av.
AddFileDependency(String)	Lägger till ett enda filnamn i samlingen med filnamn som det aktuella svaret är beroende av.
AddHeader(String, String)	Lägger till ett HTTP-huvud i utdataströmmen. AddHeader(String, String) tillhandahålls för kompatibilitet med tidigare versioner av ASP.
AddOnSendingHeaders(Action<HttpContext>)	Registrerar ett återanrop som ASP.NET-körningen anropar omedelbart innan svarshuvudena skickas för den här begäran.
AppendCookie(HttpCookie)	Lägger till en HTTP-cookie i den inbyggda cookiesamlingen.
AppendHeader(String, String)	Lägger till ett HTTP-huvud i utdataströmmen.
AppendToLog(String)	Lägger till anpassad logginformation i loggfilen Internet Information Services (IIS).
ApplyAppPathModifier(String)	Lägger till ett sessions-ID i den virtuella sökvägen om sessionen använder Cookieless sessionstillstånd och returnerar den kombinerade sökvägen. Om Cookieless sessionstillståndet inte används ApplyAppPathModifier(String) returnerar den ursprungliga virtuella sökvägen.
BeginFlush(AsyncCallback, Object)	Skickar det buffrade svaret till klienten.
BinaryWrite(Byte[])	Skriver en sträng med binära tecken till HTTP-utdataströmmen.
Clear()	Rensar alla innehållsutdata från buffertströmmen.
ClearContent()	Rensar alla innehållsutdata från buffertströmmen.
ClearHeaders()	Rensar alla huvuden från buffertströmmen.
Close()	Stänger socketanslutningen till en klient.
DisableKernelCache()	Inaktiverar kernelcachelagring för det aktuella svaret.
DisableUserCache()	Inaktiverar cachelagring i IIS-användarläge för det här svaret.
End()	Skickar alla buffrade utdata till klienten, stoppar körningen av sidan och genererar EndRequest händelsen.
EndFlush(IAsyncResult)	Slutför en asynkron tömningsåtgärd.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
Flush()	Skickar alla buffrade utdata till klienten.
FlushAsync()	Skickar asynkront alla buffrade utdata till klienten.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
Pics(String)	Lägger till ett HTTP-huvud `PICS-Label` i utdataströmmen.
PushPromise(String, String, NameValueCollection)	Stöder program som skickar push-löften till HTTP 2.0-klienter. Mer information finns i HTTP/2-specifikation avsnitt 8.2: Server push.
PushPromise(String)	Stöder program som skickar push-löften till HTTP 2.0-klienter. Mer information finns i HTTP/2-specifikation avsnitt 8.2: Server push.
Redirect(String, Boolean)	Omdirigerar en klient till en ny URL. Anger den nya URL:en och om körningen av den aktuella sidan ska avslutas.
Redirect(String)	Omdirigerar en begäran till en ny URL och anger den nya URL:en.
RedirectPermanent(String, Boolean)	Utför en permanent omdirigering från den begärda URL:en till den angivna URL:en och ger möjlighet att slutföra svaret.
RedirectPermanent(String)	Utför en permanent omdirigering från den begärda URL:en till den angivna URL:en.
RedirectToRoute(Object)	Omdirigerar en begäran till en ny URL med hjälp av vägparametervärden.
RedirectToRoute(RouteValueDictionary)	Omdirigerar en begäran till en ny URL med hjälp av vägparametervärden.
RedirectToRoute(String, Object)	Omdirigerar en begäran till en ny URL med hjälp av vägparametervärden och ett vägnamn.
RedirectToRoute(String, RouteValueDictionary)	Omdirigerar en begäran till en ny URL med hjälp av vägparametervärden och ett vägnamn.
RedirectToRoute(String)	Omdirigerar en begäran till en ny URL med hjälp av ett vägnamn.
RedirectToRoutePermanent(Object)	Utför en permanent omdirigering från en begärd URL till en ny URL med hjälp av vägparametervärden.
RedirectToRoutePermanent(RouteValueDictionary)	Utför en permanent omdirigering från en begärd URL till en ny URL med hjälp av vägparametervärden.
RedirectToRoutePermanent(String, Object)	Utför en permanent omdirigering från en begärd URL till en ny URL med hjälp av routningsparametervärdena och namnet på den väg som motsvarar den nya URL:en.
RedirectToRoutePermanent(String, RouteValueDictionary)	Utför en permanent omdirigering från en begärd URL till en ny URL med hjälp av vägparametervärden och ett vägnamn.
RedirectToRoutePermanent(String)	Utför en permanent omdirigering från en begärd URL till en ny URL med hjälp av ett vägnamn.
RemoveOutputCacheItem(String, String)	Använder den angivna utdatacacheprovidern för att ta bort alla utdatacacheobjekt som är associerade med den angivna sökvägen.
RemoveOutputCacheItem(String)	Tar bort alla cachelagrade objekt som är associerade med standardutdatacacheprovidern från cachen. Den här metoden är statisk.
SetCookie(HttpCookie)	Eftersom metoden HttpResponse.SetCookie endast är avsedd för intern användning bör du inte anropa den i koden. I stället kan du anropa metoden HttpResponse.Cookies.Set , som i följande exempel visas. Uppdaterar en befintlig cookie i cookiesamlingen.
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TransmitFile(String, Int64, Int64)	Skriver den angivna delen av en fil direkt till en HTTP-svarsutdataström utan att buffrar den i minnet.
TransmitFile(String)	Skriver den angivna filen direkt till en HTTP-svarsutdataström, utan att buffrar den i minnet.
Write(Char)	Skriver ett tecken till en HTTP-svarsutdataström.
Write(Char[], Int32, Int32)	Skriver en matris med tecken till en HTTP-svarsutdataström.
Write(Object)	Skriver en Object till en HTTP-svarsström.
Write(String)	Skriver en sträng till en HTTP-svarsutdataström.
WriteFile(IntPtr, Int64, Int64)	Skriver den angivna filen direkt till en HTTP-svarsutdataström.
WriteFile(String, Boolean)	Skriver innehållet i den angivna filen direkt till en HTTP-svarsutdataström som ett minnesblock.
WriteFile(String, Int64, Int64)	Skriver den angivna filen direkt till en HTTP-svarsutdataström.
WriteFile(String)	Skriver innehållet i den angivna filen direkt till en HTTP-svarsutdataström som ett filblock.
WriteSubstitution(HttpResponseSubstitutionCallback)	Tillåter infogning av svarsersättningsblock i svaret, vilket möjliggör dynamisk generering av angivna svarsregioner för cachelagrade utdatasvar.

Gäller för

Feedback

Var den här sidan till hjälp?