ICallbackEventHandler Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Służy do wskazywania, że kontrolka może być elementem docelowym zdarzenia wywołania zwrotnego na serwerze.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Pochodne
Uwagi
Zaimplementuj interfejs dla dowolnej niestandardowej ICallbackEventHandler kontrolki, która musi odbierać zdarzenia wywołania zwrotnego. Aby uzyskać więcej informacji, zobacz Implementowanie wywołań zwrotnych klienta bez poświadczeń zwrotnych.
Przykłady kontrolek implementujących ICallbackEventHandler interfejs obejmują kontrolki GridView, DetailsViewi TreeView . Gdy zdarzenie wywołania zwrotnego dotyczy kontrolki, która implementuje ICallbackEventHandler interfejs, RaiseCallbackEvent metoda jest wywoływana w celu obsługi zdarzenia, przekazując argument zdarzenia jako parametr, a GetCallbackResult metoda zwraca wynik wywołania zwrotnego.
Kontrolki pobierające dane z kontrolki źródła danych podczas wywołania zwrotnego mogą to zrobić synchronicznie lub asynchronicznie. ASP.NET kontrolek, takich jak GridView, DetailsViewi TreeView są implementowane synchronicznie. Synchroniczne wywołania zwrotne nie uniemożliwiają użytkownikowi pracy w przeglądarce. W trybie synchronicznym tylko jedno wywołanie zwrotne w danym momencie może zostać wykonane, a ostatnie wywołanie zwrotne ma pierwszeństwo. Gdy kontrolka sieci Web jest implementowana w celu obsługi zachowania asynchronicznego, można jednocześnie zgłaszać wiele wywołań zwrotnych. Aby uzyskać szczegółowe informacje na temat programowania asynchronicznego, zobacz Wzorzec asynchroniczny oparty na zdarzeniach (EAP).
Można określić, czy zdarzenia wywołania zwrotnego pochodzące z interfejsu użytkownika renderowane przez kontrolkę implementjącą ICallbackEventHandler interfejs są weryfikowane. Weryfikacja zdarzeń jest dobrym rozwiązaniem w zakresie zabezpieczeń. Jednak ze względu na wydajność można ją wyłączyć. Aby kontrolować, czy walidacja zdarzeń jest wykonywana w przypadku zdarzeń wywołania zwrotnego, ustaw enableEventValidation atrybut dyrektywy @ Page lub enableEventValidation atrybut elementu pages (ASP.NET Schemat ustawień) pliku Web.config. Jeśli właściwość zostanie ustawiona EnableEventValidation w kodzie, ustaw ją w Page_Init fazie przetwarzania strony. Aby uzyskać więcej informacji na temat równoważenia korzyści zabezpieczeń weryfikacji zdarzeń z kosztem wydajności, zobacz ASP.NET Omówienie wydajności.
Metody
| GetCallbackResult() |
Zwraca wyniki zdarzenia wywołania zwrotnego, które jest przeznaczone dla kontrolki. |
| RaiseCallbackEvent(String) |
Przetwarza zdarzenie wywołania zwrotnego, które jest przeznaczone dla kontrolki. |
