Aracılığıyla paylaş


HttpResponse Sınıf

Tanım

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
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 gereksiz içerik gönderilmediğinden emin olmak için yöntemini çağırır Clear . Daha sonra kod, istekte bulunan istemciye gönderilmeden önce sayfanın tamamen işlenmesi için özelliğini true olarak ayarlar BufferOutput . Ardından 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 .

Uyarı

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 , , HttpContextPageve 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önderme ile güncelleştirmek yerine sayfanın seçili bölgelerini güncelleştirmek için denetimler kullandığınızda UpdatePanel etkinleştirilir. Daha fazla bilgi için bkz . UpdatePanel Denetimine Genel Bakış ve Partial-Page İşlemeye Genel Bakış.

Oluşturucular

Name Description
HttpResponse(TextWriter)

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

Özellikler

Name Description
Buffer

Çıktının arabelleğe alınıp alınmayacağını ve tam yanıt işlendikten 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 ayarlarCache-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

İletimden önce 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 nesne 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 bağlı olup olmadığını gösteren 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ğinin gönderilip gönderilmeydiğ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önlendirmesinin 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

Name Description
AddCacheDependency(CacheDependency[])

Çıktı önbelleğinde depolanırsa ve belirtilen bağımlılıklar değişirse 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ınmış 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ılmazsa 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 bir 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()

Şu anda arabelleğe alınmış olan tüm çıkışı istemciye gönderir, sayfanın yürütülmesini durdurur ve olayı başlatır 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ışları istemciye gönderir.

FlushAsync()

Zaman uyumsuz olarak, arabelleğe alınmış olan tüm çıkışları istemciye gönderir.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
Pics(String)

Çıkış akışına bir HTTP PICS-Label üst bilgisi ekler.

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.

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.

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.

Redirect(String)

İsteği yeni bir URL'ye yönlendirir ve yeni URL'yi belirtir.

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.

RedirectPermanent(String)

İstenen URL'den belirtilen URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.

RedirectToRoute(Object)

Yol parametresi değerlerini kullanarak isteği yeni bir URL'ye yönlendirir.

RedirectToRoute(RouteValueDictionary)

Yol parametresi değerlerini 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.

RedirectToRoute(String)

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, 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.

RedirectToRoutePermanent(String)

bir yol adı kullanarak istenen URL'den yeni bir URL'ye kalıcı bir yeniden yönlendirme gerçekleştirir.

RemoveOutputCacheItem(String, String)

Belirtilen yolla ilişkili tüm çıkış önbelleği öğelerini kaldırmak için belirtilen çıktı önbelleği sağlayıcısını kullanır.

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.

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 koleksiyonundaki mevcut bir tanımlama bilgisini güncelleştirir.

ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)
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.

TransmitFile(String)

Belirtilen dosyayı 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)

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, 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.

WriteFile(String)

Belirtilen dosyanın içeriğini doğrudan bir HTTP yanıt çıkış akışına dosya bloğu olarak yazar.

WriteSubstitution(HttpResponseSubstitutionCallback)

Yanıta yanıt değiştirme bloklarının eklenmesine izin verir ve bu da çıktı önbelleğe alınmış yanıtlar için belirtilen yanıt bölgelerinin dinamik olarak oluşturulmasını sağlar.

Şunlara uygulanır