HttpResponse Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

bir ASP.NET işleminden HTTP yanıt bilgilerini kapsüller.

public ref class HttpResponse sealed

public sealed class HttpResponse

type HttpResponse = class

Public NotInheritable Class HttpResponse

Devralma: Object
HttpResponse

Örnekler

Aşağıdaki örnek, sayfa istendiğinde çakışan üç dikdörtgen çizer. Kod, özelliğini image/jpeg olarak ayarlayarak ContentType başlar, böylece sayfanın tamamı JPEG görüntüsü olarak işlenir. Kod daha sonra bu yanıtla birlikte gereksiz içerik gönderilmediğinden emin olmak için yöntemini çağırır Clear . Ardından kod özelliği true olarak ayarlar BufferOutput , böylece sayfa istekte bulunan istemciye gönderilmeden önce tamamen işlenir. Dikdörtgenleri çizmek için kullanılan iki nesne oluşturulur: a Bitmap ve nesnesi Graphics . Sayfada oluşturulan değişkenler, dikdörtgenleri ve en büyük dikdörtgenin içinde görünen bir dizeyi çizmek için koordinat olarak kullanılır.

Üç dikdörtgen ve bunların içinde görünen dize çizildiğinde, Bitmap özelliğiyle OutputStream ilişkili nesneye Stream kaydedilir ve biçimi JPEG olarak ayarlanır. Kod, iki çizim nesnesi tarafından kullanılan kaynakları serbest bırakmak için ve Dispose yöntemlerini çağırırDispose. Son olarak kod, arabelleğe alınan yanıtı istekte bulunan istemciye göndermek için yöntemini çağırır Flush .

Not

Kodda nesnesine HttpResponse anahtar sözcüğüyle Responsebaşvurulur. Örneğin, Response.Clear() yöntemine başvurur HttpResponse.Clear . sınıfı, Page geçerli örneğini HttpResponsekullanıma sunan adlı Response bir özelliğe sahiptir.

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

Açıklamalar

sınıfının yöntemleri ve özellikleri HttpResponse , , HttpContext Pageve UserControl sınıflarının HttpApplicationözelliği aracılığıyla Response kullanıma sunulur.

sınıfının aşağıdaki yöntemleri HttpResponse yalnızca geri gönderme senaryolarında desteklenir ve zaman uyumsuz geri gönderme senaryolarında desteklenmez:

Kısmi sayfa güncelleştirmeleri, sayfanın tamamını geri göndermeyle güncelleştirmek yerine sayfanın seçili bölgelerini güncelleştirmek için denetimleri kullandığınızda UpdatePanel etkinleştirilir. Daha fazla bilgi için bkz . UpdatePanel Denetimine Genel Bakış ve Kısmi Sayfa İşlemeye Genel Bakış.

Oluşturucular

HttpResponse(TextWriter)

HttpResponse sınıfının yeni bir örneğini başlatır.

Özellikler

Buffer	Çıktının arabelleğe alınıp alınmayacağını ve tam yanıtın işlenmesi tamamlandıktan sonra gönderilip gönderilmeymeyeceğini belirten bir değer alır veya ayarlar.
BufferOutput	Çıktının arabelleğe alınıp alınmayacağını ve sayfanın tamamı işlendikten sonra gönderilip gönderilmeymeyeceğini belirten bir değer alır veya ayarlar.
Cache	Web sayfasının önbelleğe alma ilkesini (süre sonu, gizlilik ayarları ve vary yan tümceleri gibi) alır.
CacheControl	Numaralandırma değerlerinden biriyle HttpCacheability eşleşen HTTP üst bilgisini alır veya ayarlar`Cache-Control`.
Charset	Çıkış akışının HTTP karakter kümesini alır veya ayarlar.
ClientDisconnectedToken	İstemci bağlantısı kesildiğinde atlayan bir CancellationToken nesne alır.
ContentEncoding	Çıkış akışının HTTP karakter kümesini alır veya ayarlar.
ContentType	Çıkış akışının HTTP MIME türünü alır veya ayarlar.
Cookies	Yanıt tanımlama bilgisi koleksiyonunu alır.
Expires	Tarayıcıda önbelleğe alınan sayfanın süresi dolmadan önce geçmesi için dakika sayısını alır veya ayarlar. Kullanıcı süresi dolmadan önce aynı sayfaya dönerse, önbelleğe alınmış sürüm görüntülenir. Expires , ASP'nin önceki sürümleriyle uyumluluk için sağlanmıştır.
ExpiresAbsolute	Önbelleğe alınan bilgilerin önbellekten kaldırılacağı mutlak tarih ve saati alır veya ayarlar. ExpiresAbsolute , ASP'nin önceki sürümleriyle uyumluluk için sağlanmıştır.
Filter	İletim öncesinde HTTP varlık gövdesini değiştirmek için kullanılan bir sarmalama filtresi nesnesini alır veya ayarlar.
HeaderEncoding	Geçerli üst bilgi çıkış akışı için kodlamayı temsil eden bir Encoding nesnesi alır veya ayarlar.
Headers	Yanıt üst bilgileri koleksiyonunu alır.
HeadersWritten	Yanıt üst bilgilerinin yazılıp yazılmadığını belirten bir değer alır.
IsClientConnected	İstemcinin sunucuya hala bağlı olup olmadığını belirten bir değer alır.
IsRequestBeingRedirected	İstemcinin yeni bir konuma aktarılıp aktarılmadığını belirten bir Boole değeri alır.
Output	Giden HTTP yanıt akışına metin çıkışını etkinleştirir.
OutputStream	Giden HTTP içerik gövdesine ikili çıkışı etkinleştirir.
RedirectLocation	HTTP `Location` üst bilgisinin değerini alır veya ayarlar.
Status	İstemciye `Status` döndürülen satırı ayarlar.
StatusCode	İstemciye döndürülen çıkışın HTTP durum kodunu alır veya ayarlar.
StatusDescription	İstemciye döndürülen çıkışın HTTP durum dizesini alır veya ayarlar.
SubStatusCode	Yanıtın durum kodunu niteleyici bir değer alır veya ayarlar.
SupportsAsyncFlush	Bağlantının zaman uyumsuz temizleme işlemlerini destekleyip desteklemediğini gösteren bir değer alır.
SuppressContent	İstemciye HTTP içeriği gönderilip gönderilmeymeyeceğini belirten bir değer alır veya ayarlar.
SuppressDefaultCacheControlHeader	Geçerli HTTP yanıtı için varsayılan `Cache Control: private` üst bilginin gizlenip gizlenmeyeceğini belirten bir değer alır veya ayarlar.
SuppressFormsAuthenticationRedirect	Form kimlik doğrulamasının oturum açma sayfasına yeniden yönlendirilmesinin gizlenip gizlenmeyeceğini belirten bir değer alır veya ayarlar.
TrySkipIisCustomErrors	IIS 7.0 özel hatalarının devre dışı bırakılıp bırakılmayacağını belirten bir değer alır veya ayarlar.

Yöntemler

AddCacheDependency(CacheDependency[])	Çıktı önbelleğinde depolanıyorsa ve belirtilen bağımlılıklar değişiyorsa yanıtın geçersiz kılınması kolaylaştırmak için bir dizi önbellek bağımlılığını yanıtla ilişkilendirir.
AddCacheItemDependencies(ArrayList)	Önbelleğe alınmış yanıtın geçerliliğini önbellekteki diğer öğelere bağımlı hale getirir.
AddCacheItemDependencies(String[])	Önbelleğe alınan bir öğenin geçerliliğini önbellekteki başka bir öğeye bağımlı hale getirir.
AddCacheItemDependency(String)	Önbelleğe alınmış yanıtın geçerliliğini önbellekteki başka bir öğeye bağımlı hale getirir.
AddFileDependencies(ArrayList)	Geçerli yanıtın bağımlı olduğu dosya adları koleksiyonuna bir grup dosya adı ekler.
AddFileDependencies(String[])	Geçerli yanıtın bağımlı olduğu dosya adları koleksiyonuna bir dosya adları dizisi ekler.
AddFileDependency(String)	Geçerli yanıtın bağımlı olduğu dosya adları koleksiyonuna tek bir dosya adı ekler.
AddHeader(String, String)	Çıkış akışına bir HTTP üst bilgisi ekler. AddHeader(String, String) , ASP'nin önceki sürümleriyle uyumluluk için sağlanmıştır.
AddOnSendingHeaders(Action<HttpContext>)	Bu istek için yanıt üst bilgileri gönderilmeden hemen önce ASP.NET çalışma zamanının çağıracağı bir geri çağırma kaydeder.
AppendCookie(HttpCookie)	İç tanımlama bilgisi koleksiyonuna bir HTTP tanımlama bilgisi ekler.
AppendHeader(String, String)	Çıkış akışına bir HTTP üst bilgisi ekler.
AppendToLog(String)	Internet Information Services (IIS) günlük dosyasına özel günlük bilgileri ekler.
ApplyAppPathModifier(String)	Oturum, oturum durumunu kullanıyorsa Cookieless sanal yola bir oturum kimliği ekler ve birleşik yolu döndürür. Oturum durumu kullanılmıyorsa Cookieless , ApplyAppPathModifier(String) özgün sanal yolu döndürür.
BeginFlush(AsyncCallback, Object)	Arabelleğe alınmış durumdaki yanıtı istemciye gönderir.
BinaryWrite(Byte[])	HTTP çıkış akışına ikili karakter dizesi yazar.
Clear()	Arabellek akışındaki tüm içerik çıkışını temizler.
ClearContent()	Arabellek akışındaki tüm içerik çıkışını temizler.
ClearHeaders()	Arabellek akışındaki tüm üst bilgileri temizler.
Close()	İstemciye yuva bağlantısını kapatır.
DisableKernelCache()	Geçerli yanıt için çekirdek önbelleğini devre dışı bırakır.
DisableUserCache()	Bu yanıt için IIS kullanıcı modu önbelleğini devre dışı bırakır.
End()	Arabelleğe alınmış olan tüm çıkışı istemciye gönderir, sayfanın yürütülmesini durdurur ve olayı tetikler EndRequest .
EndFlush(IAsyncResult)	Zaman uyumsuz temizleme işlemini tamamlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Flush()	Arabelleğe alınmış olan tüm çıkışı istemciye gönderir.
FlushAsync()	Zaman uyumsuz olarak, arabelleğe alınmış olan tüm çıktıları istemciye gönderir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Pics(String)	Çıkış akışına bir HTTP `PICS-Label` üst bilgisi ekler.
PushPromise(String)	HTTP 2.0 istemcilerine anında iletme vaatleri gönderen uygulamaları destekler. Daha fazla bilgi için bkz. HTTP/2 Belirtimi Bölüm 8.2: Sunucu Gönderme.
PushPromise(String, String, NameValueCollection)	HTTP 2.0 istemcilerine anında iletme vaatleri gönderen uygulamaları destekler. Daha fazla bilgi için bkz. HTTP/2 Belirtimi Bölüm 8.2: Sunucu Gönderme.
Redirect(String)	İsteği yeni bir URL'ye yönlendirir ve yeni URL'yi belirtir.
Redirect(String, Boolean)	İstemciyi yeni bir URL'ye yönlendirir. Yeni URL'yi ve geçerli sayfanın yürütülmesinin sonlandırılıp sonlandırılmayacağını belirtir.
RedirectPermanent(String)	İstenen URL'den belirtilen URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.
RedirectPermanent(String, Boolean)	İstenen URL'den belirtilen URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir ve yanıtı tamamlama seçeneği sağlar.
RedirectToRoute(Object)	Yönlendirme parametresi değerlerini kullanarak isteği yeni bir URL'ye yönlendirir.
RedirectToRoute(RouteValueDictionary)	Yönlendirme parametresi değerlerini kullanarak isteği yeni bir URL'ye yönlendirir.
RedirectToRoute(String)	Yol adı kullanarak isteği yeni bir URL'ye yönlendirir.
RedirectToRoute(String, Object)	Yol parametresi değerlerini ve yol adını kullanarak isteği yeni bir URL'ye yönlendirir.
RedirectToRoute(String, RouteValueDictionary)	Yol parametresi değerlerini ve yol adını kullanarak isteği yeni bir URL'ye yönlendirir.
RedirectToRoutePermanent(Object)	Yol parametresi değerlerini kullanarak istenen URL'den yeni bir URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.
RedirectToRoutePermanent(RouteValueDictionary)	Yol parametresi değerlerini kullanarak istenen URL'den yeni bir URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.
RedirectToRoutePermanent(String)	Bir yol adı kullanarak istenen URL'den yeni bir URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.
RedirectToRoutePermanent(String, Object)	Yol parametresi değerlerini ve yeni URL'ye karşılık gelen yolun adını kullanarak istenen URL'den yeni bir URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.
RedirectToRoutePermanent(String, RouteValueDictionary)	Yol parametresi değerlerini ve yol adını kullanarak istenen URL'den yeni bir URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.
RemoveOutputCacheItem(String)	Varsayılan output-cache sağlayıcısıyla ilişkili önbelleğe alınmış tüm öğeleri önbellekten kaldırır. Bu yöntem statiktir.
RemoveOutputCacheItem(String, String)	Belirtilen yol ile ilişkili tüm çıktı önbelleği öğelerini kaldırmak için belirtilen çıktı önbelleği sağlayıcısını kullanır.
SetCookie(HttpCookie)	HttpResponse.SetCookie yöntemi yalnızca iç kullanıma yönelik olduğundan, kodunuzda çağırmamalısınız. Bunun yerine, aşağıdaki örnekte gösterildiği gibi HttpResponse.Cookies.Set yöntemini çağırabilirsiniz. Tanımlama bilgisi koleksiyonunda mevcut bir tanımlama bilgisini Güncelleştirmeler.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TransmitFile(String)	Belirtilen dosyayı bellekte arabelleğe almadan doğrudan bir HTTP yanıt çıkış akışına yazar.
TransmitFile(String, Int64, Int64)	Bir dosyanın belirtilen bölümünü bellekte arabelleğe almadan doğrudan bir HTTP yanıt çıkış akışına yazar.
Write(Char)	HTTP yanıt çıkış akışına bir karakter yazar.
Write(Char[], Int32, Int32)	BIR HTTP yanıt çıkış akışına bir karakter dizisi yazar.
Write(Object)	BIR HTTP yanıt akışına yazar Object .
Write(String)	HTTP yanıt çıkış akışına bir dize yazar.
WriteFile(IntPtr, Int64, Int64)	Belirtilen dosyayı doğrudan bir HTTP yanıt çıkış akışına yazar.
WriteFile(String)	Belirtilen dosyanın içeriğini doğrudan bir HTTP yanıt çıkış akışına dosya bloğu olarak yazar.
WriteFile(String, Boolean)	Belirtilen dosyanın içeriğini doğrudan bir HTTP yanıt çıkış akışına bellek bloğu olarak yazar.
WriteFile(String, Int64, Int64)	Belirtilen dosyayı doğrudan bir HTTP yanıt çıkış akışına yazar.
WriteSubstitution(HttpResponseSubstitutionCallback)	Yanıta yanıt değiştirme bloklarının eklenmesine izin verir ve bu da çıktı önbelleğe alınan yanıtlar için belirtilen yanıt bölgelerinin dinamik olarak oluşturulmasına olanak tanır.

Şunlara uygulanır