HttpResponse Klasse

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
HttpResponse

Beispiele

Im folgenden Beispiel werden drei überlappende Rechtecke geschnitten, 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 keine überflüssigen Inhalte mit dieser Antwort 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 erstellt, die zum Zeichnen der Rechtecke verwendet werden: 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 das Bitmap Objekt gespeichert Stream , das der OutputStream Eigenschaft zugeordnet ist und das Format auf JPEG festgelegt ist. Der Code ruft die Dispose ressourcen Dispose auf, die von den beiden Zeichnungsobjekten verwendeten Ressourcen freizugeben. Schließlich ruft der Code die Methode auf, um die Flush gepufferte Antwort an den anfordernden Client zu senden.

Hinweis

Im Code wird das HttpResponse Objekt durch das Schlüsselwort Responseverwiesen. Verweist beispielsweise Response.Clear() auf die HttpResponse.Clear Methode. Die Page Klasse hat eine Eigenschaft, die benannt Response wird, die die aktuelle Instanz 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 , HttpContext, und Page UserControl Klassen verfügbar gemacht.

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

Teilweise Seitenaktualisierungen werden aktiviert, wenn Sie Steuerelemente verwenden UpdatePanel , um ausgewählte Bereiche einer Seite zu aktualisieren, anstatt die gesamte Seite mit einem Beitrag zurück zu aktualisieren. Weitere Informationen finden Sie unter UpdatePanel Control Overview and Partial-Page Rendering Overview.

Konstruktoren

Name	Beschreibung
HttpResponse(TextWriter)	Initialisiert eine neue Instanz der HttpResponse-Klasse.

Eigenschaften

Name	Beschreibung
Buffer	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Ausgabe gepuffert und gesendet werden soll, nachdem die vollständige Antwort die Verarbeitung abgeschlossen wurde.
BufferOutput	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Ausgabe gepuffert und gesendet werden soll, nachdem die gesamte Seite die Verarbeitung abgeschlossen wurde.
Cache	Ruft die Zwischenspeicherungsrichtlinie (z. B. Ablaufzeit, Datenschutzeinstellungen und unterschiedliche Klauseln) einer Webseite ab.
CacheControl	Dient zum Abrufen oder Festlegen des HTTP-Headers, der `Cache-Control` einem der HttpCacheability Enumerationswerte entspricht.
Charset	Dient zum Abrufen oder Festlegen des HTTP-Zeichensatzes des Ausgabedatenstroms.
ClientDisconnectedToken	Ruft ein CancellationToken Objekt ab, das übersprungen wird, wenn der Client die Verbindung trennt.
ContentEncoding	Dient zum Abrufen oder Festlegen des HTTP-Zeichensatzes des Ausgabedatenstroms.
ContentType	Dient zum Abrufen oder Festlegen des HTTP-MIME-Typs des Ausgabedatenstroms.
Cookies	Ruft die Antwortcookiessammlung ab.
Expires	Ruft die Anzahl der Minuten ab, bevor eine Seite in einem Browser zwischengespeichert wird, oder legt sie fest. Wenn der Benutzer vor Ablauf zur gleichen Seite zurückkehrt, wird die zwischengespeicherte Version angezeigt. Expires wird zur Kompatibilität mit früheren Versionen von ASP bereitgestellt.
ExpiresAbsolute	Dient zum Abrufen oder Festlegen des absoluten Datums und der Uhrzeit, zu dem zwischengespeicherte Informationen aus dem Cache entfernt werden sollen. ExpiresAbsolute wird zur Kompatibilität mit früheren Versionen von ASP bereitgestellt.
Filter	Dient zum Abrufen oder Festlegen eines Umbruchfilterobjekts, das zum Ändern des HTTP-Entitätstexts vor der Übertragung verwendet wird.
HeaderEncoding	Dient zum Abrufen oder Festlegen eines Encoding Objekts, das die Codierung für den aktuellen Headerausgabedatenstrom darstellt.
Headers	Ruft die Auflistung der Antwortheader 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 einen neuen Speicherort übertragen wird.
Output	Aktiviert die Ausgabe von Text in den ausgehenden HTTP-Antwortdatenstrom.
OutputStream	Aktiviert die binäre Ausgabe für den ausgehenden HTTP-Inhaltstext.
RedirectLocation	Dient zum Abrufen oder Festlegen des Werts des HTTP-Headers `Location` .
Status	Legt die `Status` Zeile fest, die an den Client zurückgegeben wird.
StatusCode	Dient zum Abrufen oder Festlegen des HTTP-Statuscodes der Ausgabe, die an den Client zurückgegeben wird.
StatusDescription	Dient zum Abrufen oder Festlegen der HTTP-Statuszeichenfolge der Ausgabe, die an den Client zurückgegeben wird.
SubStatusCode	Dient zum Abrufen oder Festlegen eines Werts, der den Statuscode der Antwort qualifiziert.
SupportsAsyncFlush	Ruft einen Wert ab, der angibt, ob die Verbindung asynchrone Flush-Vorgänge unterstützt.
SuppressContent	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob HTTP-Inhalte an den Client gesendet werden sollen.
SuppressDefaultCacheControlHeader	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Standardheader `Cache Control: private` für die aktuelle HTTP-Antwort unterdrückt werden soll.
SuppressFormsAuthenticationRedirect	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Formularauthentifizierungsumleitung auf die Anmeldeseite unterdrückt werden soll.
TrySkipIisCustomErrors	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob benutzerdefinierte IIS 7.0-Fehler deaktiviert sind.

Methoden

Name	Beschreibung
AddCacheDependency(CacheDependency[])	Ordnet eine Reihe von Cacheabhängigkeiten der Antwort zu, um die Ungültigkeit der Antwort zu erleichtern, wenn sie im Ausgabecache gespeichert ist und die angegebenen Abhängigkeiten geändert werden.
AddCacheItemDependencies(ArrayList)	Macht die Gültigkeit einer zwischengespeicherten Antwort abhängig von anderen Elementen im Cache.
AddCacheItemDependencies(String[])	Macht die Gültigkeit eines zwischengespeicherten Elements abhängig von einem anderen Element im Cache.
AddCacheItemDependency(String)	Macht die Gültigkeit einer zwischengespeicherten Antwort abhängig von einem anderen Element im Cache.
AddFileDependencies(ArrayList)	Fügt der Auflistung von Dateinamen, von denen die aktuelle Antwort abhängig ist, eine Gruppe von Dateinamen hinzu.
AddFileDependencies(String[])	Fügt der Auflistung von Dateinamen, von denen die aktuelle Antwort abhängig ist, ein Array von Dateinamen hinzu.
AddFileDependency(String)	Fügt der Auflistung von Dateinamen, von denen die aktuelle Antwort abhängig ist, einen einzelnen Dateinamen hinzu.
AddHeader(String, String)	Fügt dem Ausgabedatenstrom einen HTTP-Header hinzu. AddHeader(String, String) wird zur Kompatibilität mit früheren Versionen von ASP bereitgestellt.
AddOnSendingHeaders(Action<HttpContext>)	Registriert einen Rückruf, den die ASP.NET Laufzeit unmittelbar aufruft, bevor Antwortheader für diese Anforderung gesendet werden.
AppendCookie(HttpCookie)	Fügt der systeminternen Cookiesammlung ein HTTP-Cookie hinzu.
AppendHeader(String, String)	Fügt dem Ausgabedatenstrom einen HTTP-Header hinzu.
AppendToLog(String)	Fügt der IIS-Protokolldatei (Internet Information Services) benutzerdefinierte Protokollinformationen hinzu.
ApplyAppPathModifier(String)	Fügt dem virtuellen Pfad eine Sitzungs-ID hinzu, wenn die Sitzung den Sitzungszustand verwendet Cookieless und den kombinierten Pfad zurückgibt. Wenn Cookieless der Sitzungszustand nicht verwendet wird, ApplyAppPathModifier(String) wird der ursprüngliche virtuelle Pfad zurückgegeben.
BeginFlush(AsyncCallback, Object)	Sendet die aktuell gepufferte Antwort an den Client.
BinaryWrite(Byte[])	Schreibt eine Zeichenfolge von Binären Zeichen in den HTTP-Ausgabedatenstrom.
Clear()	Löscht alle Inhaltsausgabe aus dem Pufferdatenstrom.
ClearContent()	Löscht alle Inhaltsausgabe aus dem Pufferdatenstrom.
ClearHeaders()	Löscht alle Header aus dem Pufferdatenstrom.
Close()	Schließt die Socketverbindung mit einem Client.
DisableKernelCache()	Deaktiviert die Kernelzwischenspeicherung für die aktuelle Antwort.
DisableUserCache()	Deaktiviert das Zwischenspeichern des IIS-Benutzermodus für diese Antwort.
End()	Sendet alle aktuell gepufferten Ausgaben an den Client, beendet die Ausführung der Seite und löst das EndRequest Ereignis aus.
EndFlush(IAsyncResult)	Schließt einen asynchronen Flush-Vorgang ab.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
Flush()	Sendet alle aktuell gepufferten Ausgaben an den Client.
FlushAsync()	Sendet asynchron alle aktuell gepufferten Ausgaben an den Client.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
Pics(String)	Fügt einen HTTP-Header `PICS-Label` an den Ausgabedatenstrom an.
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.
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.
Redirect(String, Boolean)	Leitet einen Client zu einer neuen URL um. Gibt die neue URL an und gibt an, ob die Ausführung der aktuellen Seite beendet werden soll.
Redirect(String)	Leitet eine Anforderung an eine neue URL um und gibt die neue URL an.
RedirectPermanent(String, Boolean)	Führt eine dauerhafte Umleitung von der angeforderten URL zu der angegebenen URL aus und bietet die Möglichkeit, die Antwort abzuschließen.
RedirectPermanent(String)	Führt eine dauerhafte Umleitung von der angeforderten URL zu der angegebenen URL aus.
RedirectToRoute(Object)	Leitet eine Anforderung mithilfe von Routenparameterwerten an eine neue URL um.
RedirectToRoute(RouteValueDictionary)	Leitet eine Anforderung mithilfe von Routenparameterwerten an eine neue URL um.
RedirectToRoute(String, Object)	Leitet eine Anforderung mithilfe von Routenparameterwerten und einem Routennamen an eine neue URL um.
RedirectToRoute(String, RouteValueDictionary)	Leitet eine Anforderung mithilfe von Routenparameterwerten und einem Routennamen an eine neue URL um.
RedirectToRoute(String)	Leitet eine Anforderung mithilfe eines Routennamens an eine neue URL um.
RedirectToRoutePermanent(Object)	Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten aus.
RedirectToRoutePermanent(RouteValueDictionary)	Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten aus.
RedirectToRoutePermanent(String, Object)	Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe der Routenparameterwerte und des Namens der Route aus, die der neuen URL entspricht.
RedirectToRoutePermanent(String, RouteValueDictionary)	Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe von Routenparameterwerten und einem Routennamen aus.
RedirectToRoutePermanent(String)	Führt eine dauerhafte Umleitung von einer angeforderten URL zu einer neuen URL mithilfe eines Routennamens aus.
RemoveOutputCacheItem(String, String)	Verwendet den angegebenen Ausgabecacheanbieter, um alle Ausgabecacheelemente zu entfernen, die dem angegebenen Pfad zugeordnet sind.
RemoveOutputCacheItem(String)	Entfernt aus dem Cache alle zwischengespeicherten Elemente, die dem Standardmäßigen Ausgabecacheanbieter zugeordnet sind. Diese Methode ist statisch.
SetCookie(HttpCookie)	Da die HttpResponse.SetCookie-Methode nur für die interne Verwendung vorgesehen ist, sollten Sie sie nicht in Ihrem Code aufrufen. Stattdessen können Sie die HttpResponse.Cookies.Set-Methode aufrufen, wie im folgenden Beispiel gezeigt. Aktualisiert ein vorhandenes Cookie in der Cookie-Sammlung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TransmitFile(String, Int64, Int64)	Schreibt den angegebenen Teil einer Datei direkt in einen HTTP-Antwortausgabedatenstrom, ohne ihn im Arbeitsspeicher zu puffern.
TransmitFile(String)	Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom, ohne sie im Arbeitsspeicher zu puffern.
Write(Char)	Schreibt ein Zeichen in einen HTTP-Antwortausgabedatenstrom.
Write(Char[], Int32, Int32)	Schreibt ein Array von Zeichen in einen HTTP-Antwortausgabedatenstrom.
Write(Object)	Schreibt einen Object in einen HTTP-Antwortdatenstrom.
Write(String)	Schreibt eine Zeichenfolge in einen HTTP-Antwortausgabedatenstrom.
WriteFile(IntPtr, Int64, Int64)	Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.
WriteFile(String, Boolean)	Schreibt den Inhalt der angegebenen Datei direkt in einen HTTP-Antwortausgabedatenstrom als Speicherblock.
WriteFile(String, Int64, Int64)	Schreibt die angegebene Datei direkt in einen HTTP-Antwortausgabedatenstrom.
WriteFile(String)	Schreibt den Inhalt der angegebenen Datei direkt in einen HTTP-Antwortausgabedatenstrom als Dateiblock.
WriteSubstitution(HttpResponseSubstitutionCallback)	Ermöglicht das Einfügen von Antwortersetzungsblöcken in die Antwort, wodurch die dynamische Generierung von angegebenen Antwortbereichen für zwischengespeicherte Ausgabeantworten ermöglicht wird.

Gilt für:

Feedback

War diese Seite hilfreich?