Freigeben über


HttpResponse Klasse

Definition

Kapselt HTTP-Antwortinformationen aus einem ASP.NET-Vorgang.

public ref class HttpResponse sealed
public sealed class HttpResponse
type HttpResponse = class
Public NotInheritable Class HttpResponse
Vererbung
HttpResponse

Beispiele

Das folgende Beispiel zeichnet drei überlappende Rechtecke, wenn die Seite angefordert wird. Der Code beginnt mit dem Festlegen der ContentType Eigenschaft auf image/jpeg, sodass die gesamte Seite als JPEG-Bild gerendert wird. Der Code ruft dann die Clear -Methode auf, um sicherzustellen, dass mit dieser Antwort keine überflüssigen Inhalte gesendet werden. Als Nächstes legt der Code die BufferOutput Eigenschaft auf true fest, sodass die Seite vollständig verarbeitet wird, bevor sie an den anfordernden Client gesendet wird. Anschließend werden zwei Objekte zum Zeichnen der Rechtecke erstellt: ein Bitmap - und ein Graphics -Objekt. Die auf der Seite erstellten Variablen werden als Koordinaten verwendet, um die Rechtecke und eine Zeichenfolge zu zeichnen, die innerhalb des größten Rechtecks angezeigt wird.

Wenn die drei Rechtecke und die darin angezeigte Zeichenfolge gezeichnet werden, wird in Bitmap dem Stream Objekt gespeichert, das der OutputStream -Eigenschaft zugeordnet ist, und dessen Format auf JPEG festgelegt ist. Der Code ruft die Dispose Methoden und Dispose auf, um die von den beiden Zeichnungsobjekten verwendeten Ressourcen freizugeben. Schließlich ruft der Code die Flush -Methode auf, um die gepufferte Antwort an den anfordernden Client zu senden.

Hinweis

Im Code HttpResponse wird vom Schlüsselwort (keyword) Responseauf das -Objekt verwiesen. Verweist beispielsweise Response.Clear() auf die HttpResponse.Clear -Methode. Die Page -Klasse verfügt über eine Eigenschaft namensResponse, die den aktuellen instance von HttpResponseverfügbar macht.

<%@ 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>

Hinweise

Die Methoden und Eigenschaften der HttpResponse -Klasse werden über die Response -Eigenschaft der HttpApplicationKlassen , HttpContextPage, und UserControl verfügbar gemacht.

Die folgenden Methoden der HttpResponse -Klasse werden nur in Postback-Szenarien und nicht in asynchronen Postback-Szenarien unterstützt:

Partielle Seitenupdates werden aktiviert, wenn Sie Steuerelemente verwenden UpdatePanel , um ausgewählte Bereiche einer Seite zu aktualisieren, anstatt die gesamte Seite mit einem Postback zu aktualisieren. Weitere Informationen finden Sie unter Übersicht über das UpdatePanel-Steuerelement und Übersicht über teilseitiges Rendern.

Konstruktoren

HttpResponse(TextWriter)

Initialisiert eine neue Instanz der HttpResponse-Klasse.

Eigenschaften

Buffer

Ruft einen Wert ab, der angibt, ob die Ausgabe gepuffert und nach der vollständigen Verarbeitung der Antwort gesendet werden soll, oder legt diesen fest.

BufferOutput

Ruft einen Wert ab, der angibt, ob die Ausgabe gepuffert und nach der vollständigen Verarbeitung der Seite gesendet werden soll, oder legt diesen fest.

Cache

Ruft die Cachingrichtlinie für eine Webseite ab, d. h. Ablaufzeit, Datenschutzeinstellungen und Variationsklauseln.

CacheControl

Ruft den Cache-Control-HTTP-Header ab, der mit einem der HttpCacheability-Enumerationswerte übereinstimmt, oder legt diesen fest.

Charset

Ruft den HTTP-Zeichensatz des Ausgabestreams ab oder legt diesen fest.

ClientDisconnectedToken

Ruft ein CancellationToken-Objekt ab, das aktiviert wird, wenn der Client die Verbindung trennt.

ContentEncoding

Ruft den HTTP-Zeichensatz des Ausgabestreams ab oder legt diesen fest.

ContentType

Ruft den HTTP-MIME-Typ des Ausgabestreams ab oder legt diesen fest.

Cookies

Ruft die Cookieauflistung der Antwort ab.

Expires

Ruft die Anzahl der Minuten ab, nach denen eine im Browser zwischengespeicherte Seite abläuft, oder legt diese fest. Wenn der Benutzer zur selben Seite zurückkehrt, bevor diese abgelaufen ist, wird die zwischengespeicherte Version angezeigt. Expires wird bereitgestellt, um die Kompatibilität mit früheren Versionen von ASP zu gewährleisten.

ExpiresAbsolute

Ruft das absolute Datum und die Uhrzeit ab, zu der die zwischengespeicherten Informationen aus dem Cache entfernt werden sollen, oder legt diese fest. ExpiresAbsolute wird bereitgestellt, um die Kompatibilität mit früheren Versionen von ASP zu gewährleisten.

Filter

Ruft ein Wrappingfilterobjekt ab, das den HTTP--Einheitstextkörper vor der Übertragung ändern soll, oder legt dieses fest.

HeaderEncoding

Ruft ein Encoding-Objekt ab, das die Codierung für den aktuellen Headerausgabestream darstellt, oder legt dieses fest.

Headers

Ruft die Auflistung von Antwortheadern ab.

HeadersWritten

Ruft einen Wert ab, der angibt, ob die Antwortheader geschrieben wurden.

IsClientConnected

Ruft einen Wert ab, der angibt, ob der Client noch mit dem Server verbunden ist.

IsRequestBeingRedirected

Ruft einen booleschen Wert ab, der angibt, ob der Client an eine neue Adresse weitergeleitet wird.

Output

Aktiviert die Ausgabe von Text an den ausgehenden HTTP-Antwortstream.

OutputStream

Ermöglicht die binäre Ausgabe an den ausgehenden HTTP-Inhaltstext.

RedirectLocation

Ruft den Wert des HTTP-Location-Headers ab oder legt diesen fest.

Status

Legt die Status-Zeile fest, die an den Client zurückgegeben wird.

StatusCode

Ruft den HTTP-Statuscode der an den Client zurückgegebenen Ausgabe ab oder legt diesen fest.

StatusDescription

Ruft die HTTP-Statuszeichenfolge der an den Client zurückgegebenen Ausgabe ab oder legt diese fest.

SubStatusCode

Ruft einen Wert ab, der den Statuscode der Antwort qualifiziert, oder legt diesen fest.

SupportsAsyncFlush

Ruft einen Wert ab, der angibt, ob die Verbindung asynchrone Leerungsvorgänge unterstützt.

SuppressContent

Ruft einen Wert ab, der angibt, ob HTTP-Inhalt an den Client gesendet werden soll, oder legt diesen fest.

SuppressDefaultCacheControlHeader

Ruft einen Wert ab, der angibt, ob der Standardheader Cache Control: private für die aktuelle HTTP-Antwort unterdrückt werden soll, oder legt diesen fest.

SuppressFormsAuthenticationRedirect

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Umleitung der Formularauthentifizierung zur Anmeldeseite unterdrückt werden soll.

TrySkipIisCustomErrors

Ruft einen Wert ab, der angibt, ob benutzerdefinierte IIS 7.0-Fehler deaktiviert sind, oder legt diesen fest.

Methoden

AddCacheDependency(CacheDependency[])

Ordnet der Antwort Cacheabhängigkeiten zu, sodass die Antwort für ungültig erklärt werden kann, wenn sie im Ausgabecache gespeichert ist und sich die angegebenen Abhängigkeiten ändern.

AddCacheItemDependencies(ArrayList)

Macht die Gültigkeit einer zwischengespeicherten Antwort von anderen Elementen im Cache abhängig.

AddCacheItemDependencies(String[])

Macht die Gültigkeit eines zwischengespeicherten Elements von einem anderen Element im Cache abhängig.

AddCacheItemDependency(String)

Macht die Gültigkeit einer zwischengespeicherten Antwort von einem anderen Element im Cache abhängig.

AddFileDependencies(ArrayList)

Fügt der Auflistung der Dateinamen, von denen die aktuelle Antwort abhängt, eine Gruppe von Dateinamen hinzu.

AddFileDependencies(String[])

Fügt einer Auflistung von Dateinamen, von denen die aktuelle Antwort abhängt, ein Array von Dateinamen hinzu.

AddFileDependency(String)

Fügt der Auflistung der Dateinamen, von denen die aktuelle Antwort abhängt, einen einzelnen Dateinamen hinzu.

AddHeader(String, String)

Fügt dem Ausgabestream einen HTTP-Header hinzu. AddHeader(String, String) wird bereitgestellt, um die Kompatibilität mit früheren Versionen von ASP zu gewährleisten.

AddOnSendingHeaders(Action<HttpContext>)

Registriert einen Rückruf, den die ASP.NET-Laufzeit unmittelbar vor dem Senden der Antwortheader für diese Anforderung aufruft.

AppendCookie(HttpCookie)

Fügt der systeminternen Cookieauflistung ein HTTP-Cookie hinzu.

AppendHeader(String, String)

Fügt dem Ausgabestream einen HTTP-Header hinzu.

AppendToLog(String)

Fügt der IIS-Protokolldatei (Internetinformationsdienste) benutzerdefinierte Protokollinformationen hinzu.

ApplyAppPathModifier(String)

Fügt dem virtuellen Pfad eine Sitzungs-ID hinzu, wenn für die Sitzung ein Cookieless-Sitzungszustand verwendet wird, und gibt den kombinierten Pfad zurück. Wenn der Cookieless-Sitzungszustand nicht verwendet wird, gibt ApplyAppPathModifier(String) den ursprünglichen virtuellen Pfad zurück.

BeginFlush(AsyncCallback, Object)

Sendet die gesamte gegenwärtig gepufferte Antwort an den Client.

BinaryWrite(Byte[])

Schreibt eine Zeichenfolge von Binärzeichen in den HTTP-Ausgabestream.

Clear()

Löscht alle Inhaltsausgaben aus dem Pufferstream.

ClearContent()

Löscht alle Inhaltsausgaben aus dem Pufferstream.

ClearHeaders()

Löscht alle Header aus dem Pufferstream.

Close()

Schließt die Socketverbindung zu einem Client.

DisableKernelCache()

Deaktiviert die Kernelzwischenspeicherung für die aktuelle Antwort.

DisableUserCache()

Deaktiviert IIS-Benutzermodus-Caching für diese Antwort.

End()

Sendet alle derzeit gepufferten Ausgaben an den Client, beendet die Ausführung der Seite und löst das EndRequest-Ereignis aus.

EndFlush(IAsyncResult)

Schließt eine asynchrone Leerung ab.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Flush()

Sendet die gesamte gegenwärtig gepufferte Ausgabe an den Client.

FlushAsync()

Sendet die gesamte derzeit gepufferte Ausgabe asynchron an den Client.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
Pics(String)

Fügt einen HTTP-Header mit PICS-Label an den Ausgabestream an.

PushPromise(String)

Unterstützt Anwendungen, die Pushzusagen an HTTP 2.0-Clients senden. Weitere Informationen finden Sie unter HTTP/2 Specification Section 8.2: Server Push (HTTP/2-Spezifikation, Abschnitt 8.2: Serverpushvorgänge).

PushPromise(String, String, NameValueCollection)

Unterstützt Anwendungen, die Pushzusagen an HTTP 2.0-Clients senden. Weitere Informationen finden Sie unter HTTP/2 Specification Section 8.2: Server Push (HTTP/2-Spezifikation, Abschnitt 8.2: Serverpushvorgänge).

Redirect(String)

Leitet eine Anforderung an eine neue URL um und gibt die neue URL an.

Redirect(String, Boolean)

Leitet einen Client zu einer neuen URL um. Gibt die neue URL an und meldet, ob die Ausführung der aktuellen Seite beendet werden soll.

RedirectPermanent(String)

Führt eine permanente Umleitung von der angeforderten URL zur angegebenen URL aus.

RedirectPermanent(String, Boolean)

Führt eine permanente Umleitung von der angeforderten URL zur angegebenen URL aus und stellt die Option zum Abschließen der Antwort bereit.

RedirectToRoute(Object)

Leitet eine Anforderung mit Routenparameterwerten an eine neue URL um.

RedirectToRoute(RouteValueDictionary)

Leitet eine Anforderung mit Routenparameterwerten an eine neue URL um.

RedirectToRoute(String)

Leitet eine Anforderung mit einem Routennamen an eine neue URL um.

RedirectToRoute(String, Object)

Leitet eine Anforderung mit Routenparameterwerten und einem Routennamen an eine neue URL um.

RedirectToRoute(String, RouteValueDictionary)

Leitet eine Anforderung mit Routenparameterwerten und einem Routennamen an eine neue URL um.

RedirectToRoutePermanent(Object)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten aus.

RedirectToRoutePermanent(RouteValueDictionary)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten aus.

RedirectToRoutePermanent(String)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit einem Routennamen aus.

RedirectToRoutePermanent(String, Object)

Führt mit den Routenparameterwerten und dem Namen der Route, die der neuen URL entsprechen, eine permanente Umleitung von einer angeforderten URL an eine neue URL aus.

RedirectToRoutePermanent(String, RouteValueDictionary)

Führt eine permanente Umleitung von einer angeforderten URL an eine neue URL mit Routenparameterwerten und einem Routennamen aus.

RemoveOutputCacheItem(String)

Entfernt alle zwischengespeicherten Elemente aus dem Cache, die dem standardmäßigen Ausgabecacheanbieter zugeordnet sind. Dies ist eine statische Methode.

RemoveOutputCacheItem(String, String)

Verwendet den angegebenen Ausgabecacheanbieter, um alle Ausgabecacheelemente zu entfernen, die dem angegebenen Pfad zugeordnet sind.

SetCookie(HttpCookie)

Da die HttpResponse.SetCookie-Methode nur für die interne Verwendung vorgesehen ist, sollten Sie sie nicht in Ihrem Code aufrufen. Rufen Sie stattdessen wie im folgenden Beispiel gezeigt die HttpResponse.Cookies.Set-Methode auf.
Aktualisiert ein vorhandenes Cookie in der Cookieauflistung.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TransmitFile(String)

Schreibt die angegebene Datei direkt in einen HTTP-Antwort-Ausgabestream, ohne dass sie im Arbeitsspeicher gepuffert wird.

TransmitFile(String, Int64, Int64)

Schreibt den angegebenen Teil einer Datei direkt in einen HTTP-Antwort-Ausgabestream, ohne dass diese im Arbeitsspeicher gepuffert wird.

Write(Char)

Schreibt ein Zeichen in einen Ausgabestream für HTTP-Antworten.

Write(Char[], Int32, Int32)

Schreibt ein Zeichenarray in einen Ausgabestream für HTTP-Antworten.

Write(Object)

Schreibt ein Object in einen HTTP-Antwortstream.

Write(String)

Schreibt eine Zeichenfolge in einen Ausgabestream für HTTP-Antworten.

WriteFile(IntPtr, Int64, Int64)

Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.

WriteFile(String)

Schreibt den Inhalt der angegebenen Datei als Dateiblock direkt in einen HTTP-Antwort-Ausgabestream.

WriteFile(String, Boolean)

Schreibt den Inhalt der angegebenen Datei als Speicherblock direkt in einen HTTP-Antwort-Ausgabestream.

WriteFile(String, Int64, Int64)

Schreibt die angegebene Datei direkt in einen Ausgabestream für HTTP-Antworten.

WriteSubstitution(HttpResponseSubstitutionCallback)

Ermöglicht das Einfügen von Antwortersetzungsblöcken in die Antwort, wodurch das dynamische Generieren von angegebenen Antwortbereichen für Antworten im Ausgabecache ermöglicht wird.

Gilt für: