HttpResponse Klas

Definitie

Naamruimte:: System.Web

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Bevat HTTP-antwoordgegevens van een ASP.NET-bewerking.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Overname: Object
HttpResponse

Voorbeelden

In het volgende voorbeeld worden drie overlappende rechthoeken tekent wanneer de pagina wordt aangevraagd. De code begint met het instellen van de ContentType eigenschap op afbeelding/jpeg, zodat de hele pagina wordt weergegeven als JPEG-afbeelding. De code roept vervolgens de Clear methode aan om ervoor te zorgen dat er geen overbodige inhoud met dit antwoord wordt verzonden. Vervolgens stelt de code de BufferOutput eigenschap in op true, zodat de pagina volledig wordt verwerkt voordat deze naar de aanvragende client wordt verzonden. Twee objecten die worden gebruikt om de rechthoeken te tekenen, worden vervolgens gemaakt: een Bitmap en een Graphics object. De variabelen die op de pagina zijn gemaakt, worden gebruikt als coördinaten om de rechthoeken te tekenen en een tekenreeks die in de grootste rechthoek wordt weergegeven.

Wanneer de drie rechthoeken en de tekenreeks die erin wordt weergegeven, worden getekend, wordt het Bitmap opgeslagen in het Stream object dat is gekoppeld aan de OutputStream eigenschap en de indeling ervan is ingesteld op JPEG. De code roept de Dispose en Dispose methoden aan om de resources vrij te geven die door de twee tekenobjecten worden gebruikt. Ten slotte roept de code de Flush methode aan om het gebufferde antwoord naar de aanvragende client te verzenden.

Note

In code wordt het HttpResponse object aangeduid met het trefwoord Response. Verwijst bijvoorbeeld Response.Clear() naar de HttpResponse.Clear methode. De Page klasse heeft een eigenschap met de naam Response waarmee het huidige exemplaar van 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>

Opmerkingen

De methoden en eigenschappen van de HttpResponse klasse worden weergegeven via de eigenschap van de Response HttpApplication, HttpContexten Page UserControl klassen.

De volgende methoden van de HttpResponse klasse worden alleen ondersteund in scenario's na back en niet in asynchrone postback-scenario's:

Gedeeltelijke pagina-updates zijn ingeschakeld wanneer u besturingselementen gebruikt UpdatePanel om geselecteerde regio's van een pagina bij te werken in plaats van de hele pagina bij te werken met een bericht terug. Zie Overzicht van UpdatePanel-besturingselementen en Partial-Page Rendering voor meer informatie.

Constructors

Name	Description
HttpResponse(TextWriter)	Initialiseert een nieuw exemplaar van de HttpResponse klasse.

Eigenschappen

Name	Description
Buffer	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of uitvoer moet worden gebufferd en verzonden nadat het volledige antwoord is verwerkt.
BufferOutput	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of uitvoer moet worden gebufferd en verzonden nadat de volledige pagina is verwerkt.
Cache	Hiermee haalt u het cachebeleid (zoals verlooptijd, privacyinstellingen en verschillende componenten) van een webpagina op.
CacheControl	Hiermee wordt de `Cache-Control` HTTP-header opgehaald of ingesteld die overeenkomt met een van de HttpCacheability opsommingswaarden.
Charset	Hiermee haalt u de HTTP-tekenset van de uitvoerstroom op of stelt u deze in.
ClientDisconnectedToken	Hiermee wordt een CancellationToken object opgehaald dat wordt verschoven wanneer de client de verbinding verbreekt.
ContentEncoding	Hiermee haalt u de HTTP-tekenset van de uitvoerstroom op of stelt u deze in.
ContentType	Hiermee haalt u het HTTP MIME-type van de uitvoerstroom op of stelt u deze in.
Cookies	Hiermee haalt u de cookieverzameling van het antwoord op.
Expires	Hiermee wordt het aantal minuten opgehaald of ingesteld voordat een pagina in de cache van een browser verloopt. Als de gebruiker terugkeert naar dezelfde pagina voordat deze verloopt, wordt de versie in de cache weergegeven. Expires is beschikbaar voor compatibiliteit met eerdere versies van ASP.
ExpiresAbsolute	Hiermee haalt u de absolute datum en tijd op waarop gegevens in de cache uit de cache moeten worden verwijderd of ingesteld. ExpiresAbsolute is beschikbaar voor compatibiliteit met eerdere versies van ASP.
Filter	Hiermee wordt een wrapping-filterobject opgehaald of ingesteld dat wordt gebruikt om de hoofdtekst van de HTTP-entiteit te wijzigen vóór verzending.
HeaderEncoding	Hiermee wordt een Encoding object opgehaald of ingesteld dat de codering voor de huidige headeruitvoerstroom vertegenwoordigt.
Headers	Hiermee haalt u de verzameling antwoordheaders op.
HeadersWritten	Hiermee wordt een waarde opgehaald die aangeeft of de antwoordheaders zijn geschreven.
IsClientConnected	Hiermee wordt een waarde opgehaald die aangeeft of de client nog steeds is verbonden met de server.
IsRequestBeingRedirected	Hiermee wordt een Booleaanse waarde opgehaald die aangeeft of de client wordt overgedragen naar een nieuwe locatie.
Output	Hiermee wordt uitvoer van tekst naar de uitgaande HTTP-antwoordstroom ingeschakeld.
OutputStream	Hiermee wordt binaire uitvoer naar de hoofdtekst van de uitgaande HTTP-inhoud ingeschakeld.
RedirectLocation	Hiermee haalt u de waarde van de HTTP-header `Location` op of stelt u deze in.
Status	Hiermee stelt u de `Status` lijn in die naar de client wordt geretourneerd.
StatusCode	Hiermee wordt de HTTP-statuscode opgehaald of ingesteld van de uitvoer die wordt geretourneerd naar de client.
StatusDescription	Hiermee wordt de HTTP-statustekenreeks van de uitvoer opgehaald of ingesteld die wordt geretourneerd naar de client.
SubStatusCode	Hiermee wordt een waarde opgehaald of ingesteld die de statuscode van het antwoord in aanmerking komt.
SupportsAsyncFlush	Hiermee wordt een waarde opgehaald die aangeeft of de verbinding asynchrone flush-bewerkingen ondersteunt.
SuppressContent	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of HTTP-inhoud naar de client moet worden verzonden.
SuppressDefaultCacheControlHeader	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de standaardheader `Cache Control: private` voor het huidige HTTP-antwoord moet worden onderdrukt.
SuppressFormsAuthenticationRedirect	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of formulierverificatieomleiding naar de aanmeldingspagina moet worden onderdrukt.
TrySkipIisCustomErrors	Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of aangepaste IIS 7.0-fouten zijn uitgeschakeld.

Methoden

Name	Description
AddCacheDependency(CacheDependency[])	Koppelt een set cacheafhankelijkheden aan het antwoord om de ongeldigheid van het antwoord te vergemakkelijken als deze is opgeslagen in de uitvoercache en de opgegeven afhankelijkheden veranderen.
AddCacheItemDependencies(ArrayList)	Hiermee wordt de geldigheid van een reactie in de cache afhankelijk van andere items in de cache.
AddCacheItemDependencies(String[])	Hiermee wordt de geldigheid van een item in de cache afhankelijk van een ander item in de cache.
AddCacheItemDependency(String)	Hiermee wordt de geldigheid van een reactie in de cache afhankelijk van een ander item in de cache.
AddFileDependencies(ArrayList)	Hiermee voegt u een groep bestandsnamen toe aan de verzameling bestandsnamen waarop het huidige antwoord afhankelijk is.
AddFileDependencies(String[])	Voegt een matrix met bestandsnamen toe aan de verzameling bestandsnamen waarop het huidige antwoord afhankelijk is.
AddFileDependency(String)	Hiermee voegt u één bestandsnaam toe aan de verzameling bestandsnamen waarop het huidige antwoord afhankelijk is.
AddHeader(String, String)	Voegt een HTTP-header toe aan de uitvoerstroom. AddHeader(String, String) is beschikbaar voor compatibiliteit met eerdere versies van ASP.
AddOnSendingHeaders(Action<HttpContext>)	Registreert een callback die door de ASP.NET runtime direct wordt aangeroepen voordat antwoordheaders voor deze aanvraag worden verzonden.
AppendCookie(HttpCookie)	Voegt een HTTP-cookie toe aan de intrinsieke cookieverzameling.
AppendHeader(String, String)	Voegt een HTTP-header toe aan de uitvoerstroom.
AppendToLog(String)	Hiermee voegt u aangepaste logboekgegevens toe aan het logboekbestand Internet Information Services (IIS).
ApplyAppPathModifier(String)	Voegt een sessie-id toe aan het virtuele pad als de sessie de sessiestatus gebruikt Cookieless en het gecombineerde pad retourneert. Als Cookieless de sessiestatus niet wordt gebruikt, ApplyAppPathModifier(String) wordt het oorspronkelijke virtuele pad geretourneerd.
BeginFlush(AsyncCallback, Object)	Hiermee wordt het momenteel gebufferde antwoord naar de client verzonden.
BinaryWrite(Byte[])	Hiermee schrijft u een tekenreeks met binaire tekens naar de HTTP-uitvoerstroom.
Clear()	Wist alle inhoudsuitvoer van de bufferstroom.
ClearContent()	Wist alle inhoudsuitvoer van de bufferstroom.
ClearHeaders()	Hiermee wist u alle headers uit de bufferstroom.
Close()	Sluit de socketverbinding met een client.
DisableKernelCache()	Schakelt kernelcaching voor het huidige antwoord uit.
DisableUserCache()	Hiermee schakelt u opslaan in de IIS-gebruikersmodus voor dit antwoord uit.
End()	Verzendt alle momenteel gebufferde uitvoer naar de client, stopt de uitvoering van de pagina en genereert de EndRequest gebeurtenis.
EndFlush(IAsyncResult)	Voltooit een asynchrone flush-bewerking.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
Flush()	Hiermee verzendt u alle momenteel gebufferde uitvoer naar de client.
FlushAsync()	Asynchroon verzendt alle momenteel gebufferde uitvoer naar de client.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
Pics(String)	Voegt een HTTP-header `PICS-Label` toe aan de uitvoerstroom.
PushPromise(String, String, NameValueCollection)	Ondersteunt toepassingen die pushbeloften verzenden naar HTTP 2.0-clients. Zie HTTP/2 Specification Section 8.2: Server Push voor meer informatie.
PushPromise(String)	Ondersteunt toepassingen die pushbeloften verzenden naar HTTP 2.0-clients. Zie HTTP/2 Specification Section 8.2: Server Push voor meer informatie.
Redirect(String, Boolean)	Leidt een client om naar een nieuwe URL. Hiermee geeft u de nieuwe URL op en of de uitvoering van de huidige pagina moet worden beëindigd.
Redirect(String)	Hiermee wordt een aanvraag omgeleid naar een nieuwe URL en wordt de nieuwe URL opgegeven.
RedirectPermanent(String, Boolean)	Voert een permanente omleiding van de aangevraagde URL naar de opgegeven URL uit en biedt de mogelijkheid om het antwoord te voltooien.
RedirectPermanent(String)	Voert een permanente omleiding van de aangevraagde URL naar de opgegeven URL uit.
RedirectToRoute(Object)	Hiermee wordt een aanvraag omgeleid naar een nieuwe URL met behulp van routeparameterwaarden.
RedirectToRoute(RouteValueDictionary)	Hiermee wordt een aanvraag omgeleid naar een nieuwe URL met behulp van routeparameterwaarden.
RedirectToRoute(String, Object)	Hiermee wordt een aanvraag omgeleid naar een nieuwe URL met behulp van routeparameterwaarden en een routenaam.
RedirectToRoute(String, RouteValueDictionary)	Hiermee wordt een aanvraag omgeleid naar een nieuwe URL met behulp van routeparameterwaarden en een routenaam.
RedirectToRoute(String)	Hiermee wordt een aanvraag omgeleid naar een nieuwe URL met behulp van een routenaam.
RedirectToRoutePermanent(Object)	Voert een permanente omleiding van een aangevraagde URL naar een nieuwe URL uit met behulp van routeparameterwaarden.
RedirectToRoutePermanent(RouteValueDictionary)	Voert een permanente omleiding van een aangevraagde URL naar een nieuwe URL uit met behulp van routeparameterwaarden.
RedirectToRoutePermanent(String, Object)	Voert een permanente omleiding van een aangevraagde URL naar een nieuwe URL uit met behulp van de routeparameterwaarden en de naam van de route die overeenkomt met de nieuwe URL.
RedirectToRoutePermanent(String, RouteValueDictionary)	Voert een permanente omleiding van een aangevraagde URL naar een nieuwe URL uit met behulp van routeparameterwaarden en een routenaam.
RedirectToRoutePermanent(String)	Voert een permanente omleiding van een aangevraagde URL naar een nieuwe URL uit met behulp van een routenaam.
RemoveOutputCacheItem(String, String)	Hiermee gebruikt u de opgegeven provider voor uitvoercache om alle items uit de uitvoercache te verwijderen die zijn gekoppeld aan het opgegeven pad.
RemoveOutputCacheItem(String)	Hiermee verwijdert u alle items in de cache die zijn gekoppeld aan de standaard-uitvoercacheprovider. Deze methode is statisch.
SetCookie(HttpCookie)	Omdat de methode HttpResponse.SetCookie alleen is bedoeld voor intern gebruik, moet u deze niet aanroepen in uw code. In plaats daarvan kunt u de methode HttpResponse.Cookies.Set aanroepen, zoals in het volgende voorbeeld wordt weergegeven. Hiermee wordt een bestaande cookie in de cookieverzameling bijgewerkt.
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TransmitFile(String, Int64, Int64)	Hiermee schrijft u het opgegeven deel van een bestand rechtstreeks naar een HTTP-antwoorduitvoerstroom zonder dat het in het geheugen wordt gebufferd.
TransmitFile(String)	Hiermee schrijft u het opgegeven bestand rechtstreeks naar een UITVOERstroom van een HTTP-antwoord, zonder dat het in het geheugen wordt gebufferd.
Write(Char)	Hiermee schrijft u een teken naar een UITVOERstroom van een HTTP-antwoord.
Write(Char[], Int32, Int32)	Hiermee schrijft u een matrix met tekens naar een UITVOERstroom van een HTTP-antwoord.
Write(Object)	Hiermee schrijft u een Object naar een HTTP-antwoordstroom.
Write(String)	Hiermee schrijft u een tekenreeks naar een uitvoerstroom van een HTTP-antwoord.
WriteFile(IntPtr, Int64, Int64)	Hiermee schrijft u het opgegeven bestand rechtstreeks naar een UITVOERstroom van een HTTP-antwoord.
WriteFile(String, Boolean)	Hiermee schrijft u de inhoud van het opgegeven bestand rechtstreeks naar een HTTP-antwoorduitvoerstroom als geheugenblok.
WriteFile(String, Int64, Int64)	Hiermee schrijft u het opgegeven bestand rechtstreeks naar een UITVOERstroom van een HTTP-antwoord.
WriteFile(String)	Hiermee schrijft u de inhoud van het opgegeven bestand rechtstreeks naar een HTTP-antwoorduitvoerstroom als een bestandsblok.
WriteSubstitution(HttpResponseSubstitutionCallback)	Hiermee staat u invoeging van antwoordvervangingsblokken in het antwoord toe, waardoor dynamische generatie van opgegeven antwoordregio's in de cache mogelijk is.

Van toepassing op

Feedback

Is deze pagina nuttig?