HttpResponse Osztály

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

BEÁGYAZZA a HTTP-választ egy ASP.NET műveletből.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Öröklődés: Object
HttpResponse

Példák

Az alábbi példa három egymást átfedő téglalapot rajzol a lap kérésekor. A kód azzal kezdődik, hogy a ContentType tulajdonságot kép/jpeg értékre állítja, így a teljes oldal JPEG-képként jelenik meg. A kód ezután meghívja a metódust Clear annak biztosítására, hogy a rendszer ne küldjön el idegen tartalmat ezzel a válaszsal. Ezután a kód igaz értékre állítja a BufferOutput tulajdonságot, hogy az oldal teljesen feldolgozva legyen, mielőtt elküldené azt a kérelmező ügyfélnek. Ezután két objektum jön létre a téglalapok rajzolásához: egy Bitmap és egy Graphics objektum. Az oldalon létrehozott változók koordinátákként használják a téglalapok és a legnagyobb téglalapon belül megjelenő sztringek rajzolásához.

Amikor a három téglalapot és a bennük megjelenő sztringet megrajzoljuk, a rendszer a Bitmap tulajdonsághoz társított objektumba Stream menti a OutputStream fájlt, és formátuma JPEG értékre van állítva. A kód meghívja a Dispose két rajzobjektum által használt erőforrások felszabadítására szolgáló metódusokat és Dispose metódusokat. Végül a kód meghívja a Flush metódust, hogy küldje el a pufferelt választ a kérelmező ügyfélnek.

Note

A kódban az HttpResponse objektumra a kulcsszó Responsehivatkozik. Például a Response.Clear() metódusra HttpResponse.Clear hivatkozik. Az Page osztálynak van egy nevesített Response tulajdonsága, amely az aktuális példányt HttpResponseteszi elérhetővé.

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

Megjegyzések

Az osztály metódusai és tulajdonságai a HttpResponse Response , HttpApplication, HttpContextés Page osztályok tulajdonságán UserControlkeresztül jelennek meg.

Az osztály alábbi módszerei csak utólagos HttpResponse forgatókönyvekben támogatottak, aszinkron utólagos visszavételi forgatókönyvekben nem:

A részleges oldalfrissítések akkor lesznek engedélyezve, UpdatePanel ha vezérlőkkel frissíti a lap kijelölt régióinak frissítését ahelyett, hogy a teljes lapot egy visszaküldött bejegyzéssel frissítenél. További információ: UpdatePanel Control Overview and Partial-Page Rendering Overview.

Konstruktorok

Name	Description
HttpResponse(TextWriter)	Inicializálja a HttpResponse osztály új példányát.

Tulajdonságok

Name	Description
Buffer	Lekéri vagy beállít egy értéket, amely jelzi, hogy pufferelje-e a kimenetet, és küldje el a teljes válasz feldolgozása után.
BufferOutput	Lekéri vagy beállít egy értéket, amely jelzi, hogy pufferelje-e a kimenetet, és küldje el a teljes lap feldolgozása után.
Cache	Lekéri egy weblap gyorsítótárazási szabályzatát (például a lejárati időt, az adatvédelmi beállításokat és a változó záradékokat).
CacheControl	Lekéri vagy beállítja az `Cache-Control` enumerálási értékek egyikének HttpCacheability megfelelő HTTP-fejlécet.
Charset	Lekéri vagy beállítja a kimeneti stream HTTP-karakterkészletét.
ClientDisconnectedToken	CancellationToken Az ügyfél leválasztásakor megbotlott objektumot kap.
ContentEncoding	Lekéri vagy beállítja a kimeneti stream HTTP-karakterkészletét.
ContentType	Lekéri vagy beállítja a kimeneti stream HTTP MIME-típusát.
Cookies	Lekéri a válasz cookie-gyűjteményét.
Expires	Lekéri vagy beállítja a böngészőben gyorsítótárazott lap lejárata előtti percek számát. Ha a felhasználó visszatér ugyanarra a lapra, mielőtt lejár, megjelenik a gyorsítótárazott verzió. Expires az ASP korábbi verzióival való kompatibilitás érdekében van megadva.
ExpiresAbsolute	Lekéri vagy beállítja azt az abszolút dátumot és időpontot, amikor el szeretné távolítani a gyorsítótárból a gyorsítótárban tárolt adatokat. ExpiresAbsolute az ASP korábbi verzióival való kompatibilitás érdekében van megadva.
Filter	Lekéri vagy beállít egy körbefuttatási szűrőobjektumot, amely a HTTP-entitás törzsének átvitel előtti módosítására szolgál.
HeaderEncoding	Lekéri vagy beállít egy Encoding objektumot, amely az aktuális fejléc kimeneti adatfolyamának kódolását jelöli.
Headers	Lekéri a válaszfejlécek gyűjteményét.
HeadersWritten	Beolvas egy értéket, amely jelzi, hogy a válaszfejlécek meg lettek-e írva.
IsClientConnected	Beolvas egy értéket, amely jelzi, hogy az ügyfél továbbra is csatlakozik-e a kiszolgálóhoz.
IsRequestBeingRedirected	Logikai értéket kap, amely jelzi, hogy az ügyfél át lesz-e adva egy új helyre.
Output	Engedélyezi a szöveg kimenetét a kimenő HTTP-válaszfolyamba.
OutputStream	Engedélyezi a bináris kimenetet a kimenő HTTP-tartalomtörzs számára.
RedirectLocation	Lekéri vagy beállítja a HTTP-fejléc `Location` értékét.
Status	Beállítja az `Status` ügyfélnek visszaadott sort.
StatusCode	Lekéri vagy beállítja az ügyfélnek visszaadott kimenet HTTP-állapotkódját.
StatusDescription	Lekéri vagy beállítja az ügyfélnek visszaadott kimenet HTTP-állapotsztringét.
SubStatusCode	Lekéri vagy beállítja a válasz állapotkódjának megfelelő értéket.
SupportsAsyncFlush	Olyan értéket kap, amely jelzi, hogy a kapcsolat támogatja-e az aszinkron kiürítési műveleteket.
SuppressContent	Lekéri vagy beállít egy értéket, amely jelzi, hogy HTTP-tartalmat szeretne-e küldeni az ügyfélnek.
SuppressDefaultCacheControlHeader	Lekéri vagy beállítja az aktuális HTTP-válasz alapértelmezett `Cache Control: private` fejlécének letiltását jelző értéket.
SuppressFormsAuthenticationRedirect	Lekéri vagy beállítja azt az értéket, amely meghatározza, hogy el kell-e tiltani az űrlapok hitelesítési átirányítását a bejelentkezési lapra.
TrySkipIisCustomErrors	Lekéri vagy beállít egy értéket, amely meghatározza, hogy az IIS 7.0 egyéni hibái le vannak-e tiltva.

Metódusok

Name	Description
AddCacheDependency(CacheDependency[])	Gyorsítótár-függőségek készletét társítja a válaszhoz, hogy megkönnyítse a válasz érvénytelenítését, ha az a kimeneti gyorsítótárban van tárolva, és a megadott függőségek megváltoznak.
AddCacheItemDependencies(ArrayList)	A gyorsítótárazott válasz érvényességét a gyorsítótár más elemeitől teszi függővé.
AddCacheItemDependencies(String[])	Egy gyorsítótárazott elem érvényességét a gyorsítótár egy másik elemétől teszi függővé.
AddCacheItemDependency(String)	A gyorsítótárazott válasz érvényességét a gyorsítótár egy másik elemétől teszi függővé.
AddFileDependencies(ArrayList)	Fájlnevek csoportját adja hozzá azoknak a fájlneveknek a gyűjteményéhez, amelyektől az aktuális válasz függ.
AddFileDependencies(String[])	Fájlnévtömböt ad hozzá azoknak a fájlneveknek a gyűjteményéhez, amelyektől az aktuális válasz függ.
AddFileDependency(String)	Egyetlen fájlnevet ad hozzá azoknak a fájlneveknek a gyűjteményéhez, amelyektől az aktuális válasz függ.
AddHeader(String, String)	HTTP-fejlécet ad hozzá a kimeneti adatfolyamhoz. AddHeader(String, String) az ASP korábbi verzióival való kompatibilitás érdekében van megadva.
AddOnSendingHeaders(Action<HttpContext>)	Regisztrál egy visszahívást, amelyet a ASP.NET futtatókörnyezet közvetlenül a kérés válaszfejléceinek elküldése előtt hív meg.
AppendCookie(HttpCookie)	HTTP-cookie-t ad hozzá a belső cookie-gyűjteményhez.
AppendHeader(String, String)	HTTP-fejlécet ad hozzá a kimeneti adatfolyamhoz.
AppendToLog(String)	Egyéni naplóadatokat ad hozzá a Internet Information Services (IIS) naplófájlhoz.
ApplyAppPathModifier(String)	Hozzáad egy munkamenet-azonosítót a virtuális elérési úthoz, ha a munkamenet munkamenet-állapotot használ Cookieless , és a kombinált elérési utat adja vissza. Ha Cookieless a munkamenet állapota nincs használatban, ApplyAppPathModifier(String) az eredeti virtuális elérési utat adja vissza.
BeginFlush(AsyncCallback, Object)	Elküldi a jelenleg pufferelt választ az ügyfélnek.
BinaryWrite(Byte[])	Bináris karakterekből álló sztringet ír a HTTP kimeneti adatfolyamba.
Clear()	Törli a pufferfolyam összes tartalomkimenetét.
ClearContent()	Törli a pufferfolyam összes tartalomkimenetét.
ClearHeaders()	Törli az összes fejlécet a pufferfolyamból.
Close()	Bezárja a szoftvercsatorna-kapcsolatot egy ügyfélhez.
DisableKernelCache()	Letiltja a kernel gyorsítótárazását az aktuális válaszhoz.
DisableUserCache()	Letiltja az IIS felhasználói módú gyorsítótárazását ehhez a válaszhoz.
End()	Az összes jelenleg pufferelt kimenetet elküldi az ügyfélnek, leállítja a lap végrehajtását, és előhozanak egy eseményt EndRequest .
EndFlush(IAsyncResult)	Befejez egy aszinkron kiürítési műveletet.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Flush()	Az összes jelenleg pufferelt kimenetet elküldi az ügyfélnek.
FlushAsync()	Aszinkron módon küldi el az összes jelenleg pufferelt kimenetet az ügyfélnek.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Pics(String)	HTTP-fejléc `PICS-Label` hozzáfűzése a kimeneti adatfolyamhoz.
PushPromise(String, String, NameValueCollection)	Támogatja azokat az alkalmazásokat, amelyek leküldéses ígéreteket küldenek a HTTP 2.0-ügyfeleknek. További információ: HTTP/2 Specifikáció 8.2. szakasz: Kiszolgáló leküldése.
PushPromise(String)	Támogatja azokat az alkalmazásokat, amelyek leküldéses ígéreteket küldenek a HTTP 2.0-ügyfeleknek. További információ: HTTP/2 Specifikáció 8.2. szakasz: Kiszolgáló leküldése.
Redirect(String, Boolean)	Átirányítja az ügyfelet egy új URL-címre. Megadja az új URL-címet, és azt, hogy az aktuális lap végrehajtása leáll-e.
Redirect(String)	Átirányít egy kérést egy új URL-címre, és megadja az új URL-címet.
RedirectPermanent(String, Boolean)	Végleges átirányítást hajt végre a kért URL-címről a megadott URL-címre, és lehetővé teszi a válasz befejezését.
RedirectPermanent(String)	Végleges átirányítást hajt végre a kért URL-címről a megadott URL-címre.
RedirectToRoute(Object)	Átirányítja a kérést egy új URL-címre az útvonalparaméter-értékek használatával.
RedirectToRoute(RouteValueDictionary)	Átirányítja a kérést egy új URL-címre az útvonalparaméter-értékek használatával.
RedirectToRoute(String, Object)	Átirányítja a kérést egy új URL-címre az útvonalparaméter-értékek és az útvonalnév használatával.
RedirectToRoute(String, RouteValueDictionary)	Átirányítja a kérést egy új URL-címre az útvonalparaméter-értékek és az útvonalnév használatával.
RedirectToRoute(String)	Átirányítja a kérést egy új URL-címre egy útvonalnév használatával.
RedirectToRoutePermanent(Object)	Állandó átirányítást hajt végre egy kért URL-címről egy új URL-címre útvonalparaméter-értékek használatával.
RedirectToRoutePermanent(RouteValueDictionary)	Állandó átirányítást hajt végre egy kért URL-címről egy új URL-címre útvonalparaméter-értékek használatával.
RedirectToRoutePermanent(String, Object)	A kért URL-címről egy új URL-címre történő végleges átirányítást hajt végre az útvonal paraméterértékeinek és az új URL-címnek megfelelő útvonal nevének használatával.
RedirectToRoutePermanent(String, RouteValueDictionary)	Állandó átirányítást hajt végre a kért URL-címről egy új URL-címre az útvonalparaméter-értékek és az útvonalnév használatával.
RedirectToRoutePermanent(String)	Egy útvonalnév használatával végleges átirányítást hajt végre a kért URL-címről egy új URL-címre.
RemoveOutputCacheItem(String, String)	A megadott kimeneti gyorsítótár-szolgáltató használatával távolítja el a megadott elérési úthoz társított összes kimeneti gyorsítótár-elemet.
RemoveOutputCacheItem(String)	Eltávolítja a gyorsítótárból az alapértelmezett kimeneti gyorsítótár-szolgáltatóhoz társított összes gyorsítótárazott elemet. Ez a módszer statikus.
SetCookie(HttpCookie)	Mivel a HttpResponse.SetCookie metódus csak belső használatra készült, nem szabad meghívnia a kódban. Ehelyett meghívhatja a HttpResponse.Cookies.Set metódust, ahogy az alábbi példa is mutatja. Frissít egy meglévő cookie-t a cookie-gyűjteményben.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
TransmitFile(String, Int64, Int64)	A fájl megadott részét közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja anélkül, hogy puffereli azt a memóriába.
TransmitFile(String)	A megadott fájlt közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja, anélkül, hogy puffereli azt a memóriában.
Write(Char)	Karaktert ír egy HTTP-válasz kimeneti adatfolyamára.
Write(Char[], Int32, Int32)	Karaktertömböt ír egy HTTP-válasz kimeneti streambe.
Write(Object)	Object HTTP-válaszfolyamba ír.
Write(String)	Sztringet ír egy HTTP-válasz kimeneti adatfolyamára.
WriteFile(IntPtr, Int64, Int64)	A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.
WriteFile(String, Boolean)	A megadott fájl tartalmát közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja memóriablokkként.
WriteFile(String, Int64, Int64)	A megadott fájlt közvetlenül egy HTTP-válasz kimeneti streambe írja.
WriteFile(String)	A megadott fájl tartalmát közvetlenül egy HTTP-válasz kimeneti adatfolyamba írja fájlblokkként.
WriteSubstitution(HttpResponseSubstitutionCallback)	Lehetővé teszi válaszhelyettesítési blokkok beszúrását a válaszba, ami lehetővé teszi a megadott válaszrégiók dinamikus létrehozását a kimeneti gyorsítótárazott válaszokhoz.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?