HttpResponse.AddOnSendingHeaders(Action<HttpContext>) Metode

Definisi

Ruang nama:

System.Web

Rakitan:

System.Web.dll

Mendaftarkan panggilan balik yang akan dipanggil runtime ASP.NET segera sebelum header respons dikirim untuk permintaan ini.

public:
 System::Web::ISubscriptionToken ^ AddOnSendingHeaders(Action<System::Web::HttpContext ^> ^ callback);

public System.Web.ISubscriptionToken AddOnSendingHeaders(Action<System.Web.HttpContext> callback);

member this.AddOnSendingHeaders : Action<System.Web.HttpContext> -> System.Web.ISubscriptionToken

Public Function AddOnSendingHeaders (callback As Action(Of HttpContext)) As ISubscriptionToken

Parameter

callback

Action<HttpContext>

Metode panggilan balik.

Mengembalikan

ISubscriptionToken

Objek ISubscriptionToken yang mewakili langganan ke peristiwa pseudo OnSendingHeaders.

Keterangan

Important

Metode AddOnSendingHeaders tidak dipanggil jika modul asli menghapus respons terlebih dahulu.

Kejadian pseudo OnSendingHeaders berbeda dari peristiwa alur tingkat IHttpModule karena merupakan langganan per permintaan daripada langganan per aplikasi. Tujuannya adalah bahwa panggilan balik dapat mengubah kode status respons atau dapat mengatur cookie atau header respons. Catatan penggunaan dan peringatan lainnya:

• Metode ini hanya efektif ketika IIS berjalan dalam alur mode alur terintegrasi dan hanya jika header respons belum dikirim untuk permintaan saat ini.

• Runtime ASP.NET tidak menjamin apa pun tentang utas tempat panggilan balik dipanggil. Misalnya, panggilan balik dapat dipanggil secara sinkron di utas latar belakang jika flush latar belakang sedang dilakukan. Current tidak dijamin tersedia dalam utas tersebut.

• Panggilan balik tidak boleh memanggil metode apa pun yang memanipulasi isi entitas respons atau yang menghasilkan flush. Misalnya, panggilan balik tidak boleh memanggil Redirect, karena metode tersebut dapat memanipulasi isi entitas respons.

• Panggilan balik hanya boleh berisi kode sinkron yang berjalan pendek. Mencoba memanggil operasi asinkron atau menunggu operasi seperti itu dapat mengakibatkan kebuntuan.

• Panggilan balik tidak boleh melemparkan pengecualian; jika tidak, perilaku tidak ditentukan.