ICallbackEventHandler Antarmuka

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Digunakan untuk menunjukkan bahwa kontrol dapat menjadi target peristiwa panggilan balik di server.

public interface class ICallbackEventHandler

public interface ICallbackEventHandler

type ICallbackEventHandler = interface

Public Interface ICallbackEventHandler

Turunan

System.Web.UI.WebControls.DetailsView

System.Web.UI.WebControls.GridView

System.Web.UI.WebControls.TreeView

Keterangan

Terapkan ICallbackEventHandler antarmuka untuk kontrol kustom apa pun yang perlu menerima peristiwa panggilan balik. Untuk informasi selengkapnya, lihat Menerapkan Panggilan Balik Klien Tanpa Postback.

Contoh kontrol yang mengimplementasikan ICallbackEventHandler antarmuka termasuk GridViewkontrol , , DetailsViewdan TreeView . Ketika peristiwa panggilan balik menargetkan kontrol yang mengimplementasikan ICallbackEventHandler antarmuka, RaiseCallbackEvent metode dipanggil untuk menangani peristiwa, meneruskan argumen peristiwa sebagai parameter dan GetCallbackResult metode mengembalikan hasil panggilan balik.

Kontrol yang mengambil data dari kontrol sumber data selama panggilan balik dapat melakukannya secara sinkron atau asinkron. ASP.NET kontrol seperti GridView, DetailsView, dan TreeView diimplementasikan secara sinkron. Panggilan balik sinkron tidak mencegah pengguna bekerja di browser. Dalam mode sinkron, hanya satu panggilan balik pada satu waktu yang dapat dijalankan, dengan panggilan balik terakhir yang diutamakan. Ketika kontrol Web diimplementasikan untuk mendukung perilaku asinkron, beberapa panggilan balik dapat dinaikkan secara bersamaan. Untuk detail tentang pemrograman asinkron, lihat Pola Asinkron Berbasis Peristiwa (EAP).

Anda dapat menentukan apakah peristiwa panggilan balik yang berasal dari antarmuka pengguna yang dirender oleh kontrol yang mengimplementasikan antarmuka divalidasi ICallbackEventHandler . Validasi peristiwa adalah praktik keamanan yang baik. Namun, untuk alasan performa, Anda dapat menonaktifkannya. Untuk mengontrol apakah validasi peristiwa dilakukan pada peristiwa panggilan balik, atur enableEventValidation atribut arahan Halaman @ atau enableEventValidation atribut elemen halaman (Skema Pengaturan ASP.NET) dari file Web.config. Jika Anda mengatur EnableEventValidation properti dalam kode, atur dalam Page_Init fase pemrosesan halaman. Untuk informasi selengkapnya tentang menyeimbangkan manfaat keamanan validasi peristiwa dengan biaya performanya, lihat Gambaran Umum Performa ASP.NET.

Metode

GetCallbackResult()	Mengembalikan hasil peristiwa panggilan balik yang menargetkan kontrol.
RaiseCallbackEvent(String)	Memproses peristiwa panggilan balik yang menargetkan kontrol.

Lihat juga

• GetCallbackEventReference
• ICallbackEventHandler.RaiseCallbackEvent(String)
• ICallbackEventHandler.RaiseCallbackEvent(String)
• ICallbackEventHandler.RaiseCallbackEvent(String)