ICallbackEventHandler Interfejs

Definicja

Służy do wskazywania, że formant może być obiektem docelowym zdarzenia wywołania zwrotnego na serwerze.Used to indicate that a control can be the target of a callback event on the server.

public interface class ICallbackEventHandler
public interface ICallbackEventHandler
type ICallbackEventHandler = interface
Public Interface ICallbackEventHandler
Pochodne

Uwagi

Zaimplementuj ICallbackEventHandler interfejs dla dowolnej kontrolki niestandardowej, która musi odbierać zdarzenia wywołania zwrotnego.Implement the ICallbackEventHandler interface for any custom control that needs to receive callback events. Aby uzyskać więcej informacji, zobacz implementowanie wywołań zwrotnych klienta bez ogłaszania zwrotnego.For more information, see Implementing Client Callbacks Without Postbacks.

Przykłady formantów, które implementują ICallbackEventHandler interfejs, obejmują GridView DetailsView kontrolki,, i TreeView .Examples of controls that implement the ICallbackEventHandler interface include the GridView, DetailsView, and TreeView controls. Gdy zdarzenie wywołania zwrotnego odwołuje się do kontrolki implementującej ICallbackEventHandler interfejs, RaiseCallbackEvent Metoda jest wywoływana w celu obsłużenia zdarzenia, przekazanie argumentu zdarzenia jako parametru, a GetCallbackResult Metoda zwraca wynik wywołania zwrotnego.When a callback event targets a control that implements the ICallbackEventHandler interface, the RaiseCallbackEvent method is called to handle the event, passing the event argument as a parameter and the GetCallbackResult method returns the result of the callback.

Kontrolki pobierające dane z kontrolki źródła danych podczas wywołania zwrotnego można wykonać synchronicznie lub asynchronicznie.Controls that retrieve data from a data source control during callback can do so synchronously or asynchronously. ASP.NET formanty GridView , DetailsView i TreeView są zaimplementowane synchronicznie.ASP.NET controls like GridView, DetailsView, and TreeView are implemented synchronously. Synchroniczne wywołania zwrotne nie uniemożliwiają użytkownikowi pracy w przeglądarce.Synchronous callbacks do not prevent the user from working in the browser. W trybie synchronicznym można wykonać tylko jedno wywołanie zwrotne w czasie przy ostatnim priorytecie wywołania zwrotnego.In synchronous mode, only one callback at a time can execute, with the last callback taking precedence. Gdy kontrolka sieci Web jest zaimplementowana do obsługi zachowania asynchronicznego, jednocześnie może zostać podniesionych wiele wywołań zwrotnych.When a Web control is implemented to support asynchronous behavior, multiple callbacks can be raised simultaneously. Aby uzyskać szczegółowe informacje o programowaniu asynchronicznym, zobacz temat asynchroniczny wzorzec oparty na zdarzeniach (EAP).For details on asynchronous programming, see Event-based Asynchronous Pattern (EAP).

Można określić, czy zdarzenia wywołania zwrotnego pochodzące z interfejsu użytkownika renderowane przez kontrolkę implementującą ICallbackEventHandler interfejs są weryfikowane.You can specify whether callback events originating from the user interface rendered by a control implementing the ICallbackEventHandler interface are validated. Sprawdzanie poprawności zdarzeń jest dobrym sposobem na bezpieczeństwo.Validation of events is a good security practice. Jednak ze względu na wydajność można ją wyłączyć.However, for performance reasons you can disable it. Aby kontrolować, czy sprawdzanie poprawności zdarzeń odbywa się w przypadku zdarzeń wywołania zwrotnego, należy ustawić enableEventValidation atrybut @ Page dyrektywy lub enableEventValidation atrybut elementu Pages (ASP.NET Settings Schema) pliku Web.config.To control whether event validation is performed on callback events, set the enableEventValidation attribute of the @ Page directive or the enableEventValidation attribute of the pages Element (ASP.NET Settings Schema) of the Web.config file. Jeśli ustawisz EnableEventValidation Właściwość w kodzie, ustaw ją w Page_Init fazie przetwarzania strony.If you set the EnableEventValidation property in code, set it in the Page_Init phase of page processing. Aby uzyskać więcej informacji na temat równoważenia korzyści związanych z bezpieczeństwem w celu sprawdzenia poprawności zdarzeń, zobacz ASP.NET Performance Overview.For more information on balancing the security benefit of event validation with its performance cost, see ASP.NET Performance Overview.

Metody

GetCallbackResult()

Zwraca wyniki zdarzenia wywołania zwrotnego, które jest przeznaczone dla kontrolki.Returns the results of a callback event that targets a control.

RaiseCallbackEvent(String)

Przetwarza zdarzenie wywołania zwrotnego, które odwołuje się do kontrolki.Processes a callback event that targets a control.

Dotyczy

Zobacz też