ICallbackEventHandler Antarmuka
Definisi
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.
Digunakan untuk menunjukkan bahwa kontrol dapat menjadi target peristiwa panggilan balik di server.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Turunan
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. |
