ICallbackEventHandler Interfejs

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Służy do wskazywania, że kontrolka może być elementem docelowym zdarzenia wywołania zwrotnego na serwerze.

public interface class ICallbackEventHandler
public interface ICallbackEventHandler
type ICallbackEventHandler = interface
Public 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, które pobierają 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ę implementująca 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.

Dotyczy

Zobacz też