HttpResponse Kelas

Referensi

Definisi

Ruang nama:: System.Web

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Merangkum informasi respons HTTP dari operasi ASP.NET.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Warisan: Object
HttpResponse

Contoh

Contoh berikut menggambar tiga persegi panjang yang tumpang tindih saat halaman diminta. Kode dimulai dengan mengatur ContentType properti ke gambar/jpeg, sehingga seluruh halaman akan dirender sebagai gambar JPEG. Kode kemudian memanggil Clear metode untuk memastikan bahwa tidak ada konten asing yang dikirim dengan respons ini. Selanjutnya, kode mengatur properti ke true sehingga halaman sepenuhnya diproses BufferOutput sebelum dikirim ke klien yang meminta. Dua objek yang digunakan untuk menggambar persegi panjang kemudian dibuat: a Bitmap dan Graphics objek . Variabel yang dibuat di halaman digunakan sebagai koordinat untuk menggambar persegi panjang dan string yang muncul di dalam persegi panjang terbesar.

Ketika tiga persegi panjang dan string yang muncul di dalamnya digambar, Bitmap disimpan ke Stream objek yang terkait dengan OutputStream properti dan formatnya diatur ke JPEG. Kode ini memanggil Dispose metode dan Dispose untuk merilis sumber daya yang digunakan oleh dua objek gambar. Terakhir, kode memanggil Flush metode untuk mengirim respons buffer ke klien yang meminta.

Catatan

Dalam kode, HttpResponse objek disebut oleh kata kunci Response. Misalnya, Response.Clear() mengacu pada HttpResponse.Clear metode . Kelas Page memiliki properti bernama yang Response mengekspos instans saat ini dari 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>

Keterangan

Metode dan properti HttpResponse kelas diekspos melalui Response properti kelas HttpApplication, , HttpContext Page, dan UserControl .

Metode HttpResponse kelas berikut hanya didukung dalam skenario post back dan bukan dalam skenario post back asinkron:

Pembaruan sebagian halaman diaktifkan saat Anda menggunakan UpdatePanel kontrol untuk memperbarui wilayah halaman yang dipilih alih-alih memperbarui seluruh halaman dengan posting kembali. Untuk informasi selengkapnya, lihat Gambaran Umum Kontrol UpdatePanel dan Gambaran Umum Penyajian Halaman Parsial.

Konstruktor

HttpResponse(TextWriter)

Menginisialisasi instans baru kelas HttpResponse.

Properti

Buffer	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan buffer output dan mengirimkannya setelah respons lengkap selesai diproses.
BufferOutput	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan buffer output dan mengirimkannya setelah halaman selesai diproses.
Cache	Mendapatkan kebijakan penembolokan (seperti waktu kedaluwarsa, pengaturan privasi, dan berbagai klausa) dari halaman Web.
CacheControl	Mendapatkan atau mengatur `Cache-Control` header HTTP yang cocok dengan HttpCacheability salah satu nilai enumerasi.
Charset	Mendapatkan atau mengatur kumpulan karakter HTTP dari aliran output.
ClientDisconnectedToken	Mendapatkan objek yang tersandung CancellationToken saat klien terputus.
ContentEncoding	Mendapatkan atau mengatur kumpulan karakter HTTP dari aliran output.
ContentType	Mendapatkan atau mengatur jenis HTTP MIME dari aliran output.
Cookies	Mendapatkan koleksi cookie respons.
Expires	Mendapatkan atau mengatur jumlah menit sebelum halaman di-cache pada browser kedaluwarsa. Jika pengguna kembali ke halaman yang sama sebelum kedaluwarsa, versi cache ditampilkan. Expires disediakan untuk kompatibilitas dengan versi ASP yang lebih lama.
ExpiresAbsolute	Mendapatkan atau mengatur tanggal dan waktu absolut untuk menghapus informasi cache dari cache. ExpiresAbsolute disediakan untuk kompatibilitas dengan versi ASP yang lebih lama.
Filter	Mendapatkan atau mengatur objek filter pembungkus yang digunakan untuk memodifikasi isi entitas HTTP sebelum transmisi.
HeaderEncoding	Mendapatkan atau mengatur Encoding objek yang mewakili pengodean untuk aliran output header saat ini.
Headers	Mendapatkan kumpulan header respons.
HeadersWritten	Mendapatkan nilai yang menunjukkan apakah header respons telah ditulis.
IsClientConnected	Mendapatkan nilai yang menunjukkan apakah klien masih tersambung ke server.
IsRequestBeingRedirected	Mendapatkan nilai Boolean yang menunjukkan apakah klien sedang ditransfer ke lokasi baru.
Output	Memungkinkan output teks ke aliran respons HTTP keluar.
OutputStream	Mengaktifkan output biner ke isi konten HTTP keluar.
RedirectLocation	Mendapatkan atau mengatur nilai header HTTP `Location` .
Status	`Status` Mengatur baris yang dikembalikan ke klien.
StatusCode	Mendapatkan atau mengatur kode status HTTP dari output yang dikembalikan ke klien.
StatusDescription	Mendapatkan atau mengatur string status HTTP dari output yang dikembalikan ke klien.
SubStatusCode	Mendapatkan atau menetapkan nilai yang memenuhi syarat kode status respons.
SupportsAsyncFlush	Mendapatkan nilai yang menunjukkan apakah koneksi mendukung operasi flush asinkron.
SuppressContent	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengirim konten HTTP ke klien.
SuppressDefaultCacheControlHeader	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menekan header default `Cache Control: private` untuk respons HTTP saat ini.
SuppressFormsAuthenticationRedirect	Mendapatkan atau menetapkan nilai yang menentukan apakah pengalihan autentikasi formulir ke halaman masuk harus ditekan.
TrySkipIisCustomErrors	Mendapatkan atau menetapkan nilai yang menentukan apakah kesalahan kustom IIS 7.0 dinonaktifkan.

Metode

AddCacheDependency(CacheDependency[])	Mengaitkan sekumpulan dependensi cache dengan respons untuk memfasilitasi pembatalan respons jika disimpan dalam cache output dan dependensi yang ditentukan berubah.
AddCacheItemDependencies(ArrayList)	Membuat validitas respons yang di-cache bergantung pada item lain dalam cache.
AddCacheItemDependencies(String[])	Membuat validitas item yang di-cache bergantung pada item lain dalam cache.
AddCacheItemDependency(String)	Membuat validitas respons yang di-cache bergantung pada item lain dalam cache.
AddFileDependencies(ArrayList)	Menambahkan sekelompok nama file ke kumpulan nama file tempat respons saat ini bergantung.
AddFileDependencies(String[])	Menambahkan array nama file ke kumpulan nama file yang bergantung pada respons saat ini.
AddFileDependency(String)	Menambahkan satu nama file ke kumpulan nama file tempat respons saat ini bergantung.
AddHeader(String, String)	Menambahkan header HTTP ke aliran output. AddHeader(String, String) disediakan untuk kompatibilitas dengan versi ASP yang lebih lama.
AddOnSendingHeaders(Action<HttpContext>)	Mendaftarkan panggilan balik yang akan dipanggil runtime ASP.NET segera sebelum header respons dikirim untuk permintaan ini.
AppendCookie(HttpCookie)	Menambahkan cookie HTTP ke koleksi cookie intrinsik.
AppendHeader(String, String)	Menambahkan header HTTP ke aliran output.
AppendToLog(String)	Menambahkan informasi log kustom ke file log Internet Information Services (IIS).
ApplyAppPathModifier(String)	Menambahkan ID sesi ke jalur virtual jika sesi menggunakan Cookieless status sesi dan mengembalikan jalur gabungan. Jika Cookieless status sesi tidak digunakan, ApplyAppPathModifier(String) mengembalikan jalur virtual asli.
BeginFlush(AsyncCallback, Object)	Mengirim respons yang saat ini di-buffer ke klien.
BinaryWrite(Byte[])	Menulis string karakter biner ke aliran output HTTP.
Clear()	Menghapus semua output konten dari aliran buffer.
ClearContent()	Menghapus semua output konten dari aliran buffer.
ClearHeaders()	Menghapus semua header dari aliran buffer.
Close()	Menutup koneksi soket ke klien.
DisableKernelCache()	Menonaktifkan penembolokan kernel untuk respons saat ini.
DisableUserCache()	Menonaktifkan penembolokan mode pengguna IIS untuk respons ini.
End()	Mengirim semua output yang saat ini di-buffer ke klien, menghentikan eksekusi halaman, dan menaikkan EndRequest peristiwa.
EndFlush(IAsyncResult)	Menyelesaikan operasi flush asinkron.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Flush()	Mengirim semua output yang saat ini di-buffer ke klien.
FlushAsync()	Secara asinkron mengirimkan semua output yang saat ini di-buffer ke klien.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Pics(String)	Menambahkan header HTTP `PICS-Label` ke aliran output.
PushPromise(String)	Mendukung aplikasi yang mengirim janji dorong ke klien HTTP 2.0. Untuk informasi selengkapnya, lihat Bagian Spesifikasi HTTP/2 8.2: Pendorongan Server.
PushPromise(String, String, NameValueCollection)	Mendukung aplikasi yang mengirim janji dorong ke klien HTTP 2.0. Untuk informasi selengkapnya, lihat Bagian Spesifikasi HTTP/2 8.2: Pendorongan Server.
Redirect(String)	Mengalihkan permintaan ke URL baru dan menentukan URL baru.
Redirect(String, Boolean)	Mengalihkan klien ke URL baru. Menentukan URL baru dan apakah eksekusi halaman saat ini harus dihentikan.
RedirectPermanent(String)	Melakukan pengalihan permanen dari URL yang diminta ke URL yang ditentukan.
RedirectPermanent(String, Boolean)	Melakukan pengalihan permanen dari URL yang diminta ke URL yang ditentukan, dan menyediakan opsi untuk menyelesaikan respons.
RedirectToRoute(Object)	Mengalihkan permintaan ke URL baru dengan menggunakan nilai parameter rute.
RedirectToRoute(RouteValueDictionary)	Mengalihkan permintaan ke URL baru dengan menggunakan nilai parameter rute.
RedirectToRoute(String)	Mengalihkan permintaan ke URL baru dengan menggunakan nama rute.
RedirectToRoute(String, Object)	Mengalihkan permintaan ke URL baru dengan menggunakan nilai parameter rute dan nama rute.
RedirectToRoute(String, RouteValueDictionary)	Mengalihkan permintaan ke URL baru dengan menggunakan nilai parameter rute dan nama rute.
RedirectToRoutePermanent(Object)	Melakukan pengalihan permanen dari URL yang diminta ke URL baru dengan menggunakan nilai parameter rute.
RedirectToRoutePermanent(RouteValueDictionary)	Melakukan pengalihan permanen dari URL yang diminta ke URL baru dengan menggunakan nilai parameter rute.
RedirectToRoutePermanent(String)	Melakukan pengalihan permanen dari URL yang diminta ke URL baru dengan menggunakan nama rute.
RedirectToRoutePermanent(String, Object)	Melakukan pengalihan permanen dari URL yang diminta ke URL baru dengan menggunakan nilai parameter rute dan nama rute yang sesuai dengan URL baru.
RedirectToRoutePermanent(String, RouteValueDictionary)	Melakukan pengalihan permanen dari URL yang diminta ke URL baru dengan menggunakan nilai parameter rute dan nama rute.
RemoveOutputCacheItem(String)	Menghapus dari cache semua item yang di-cache yang terkait dengan penyedia output-cache default. Metode ini statis.
RemoveOutputCacheItem(String, String)	Menggunakan penyedia output-cache yang ditentukan untuk menghapus semua item output-cache yang terkait dengan jalur yang ditentukan.
SetCookie(HttpCookie)	Karena metode HttpResponse.SetCookie hanya ditujukan untuk penggunaan internal, Anda tidak boleh memanggilnya dalam kode Anda. Sebagai gantinya, Anda dapat memanggil metode HttpResponse.Cookies.Set , seperti yang ditunjukkan contoh berikut. Updates cookie yang ada di koleksi cookie.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TransmitFile(String)	Menulis file yang ditentukan langsung ke aliran output respons HTTP, tanpa buffering dalam memori.
TransmitFile(String, Int64, Int64)	Menulis bagian file yang ditentukan langsung ke aliran output respons HTTP tanpa buffering dalam memori.
Write(Char)	Menulis karakter ke aliran output respons HTTP.
Write(Char[], Int32, Int32)	Menulis array karakter ke aliran output respons HTTP.
Write(Object)	Object Menulis ke aliran respons HTTP.
Write(String)	Menulis string ke aliran output respons HTTP.
WriteFile(IntPtr, Int64, Int64)	Menulis file yang ditentukan langsung ke aliran output respons HTTP.
WriteFile(String)	Menulis konten file yang ditentukan langsung ke aliran output respons HTTP sebagai blok file.
WriteFile(String, Boolean)	Menulis konten file yang ditentukan langsung ke aliran output respons HTTP sebagai blok memori.
WriteFile(String, Int64, Int64)	Menulis file yang ditentukan langsung ke aliran output respons HTTP.
WriteSubstitution(HttpResponseSubstitutionCallback)	Memungkinkan penyisipan blok substitusi respons ke dalam respons, yang memungkinkan pembuatan dinamis wilayah respons tertentu untuk respons cache output.

Berlaku untuk