ICallbackEventHandler ICallbackEventHandler ICallbackEventHandler ICallbackEventHandler Interface

Definizione

Viene utilizzata per indicare che un controllo può essere la destinazione di un evento di callback sul server.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
Derivato

Commenti

Implementare l' ICallbackEventHandler interfaccia per qualsiasi controllo personalizzato che deve ricevere eventi di callback.Implement the ICallbackEventHandler interface for any custom control that needs to receive callback events. Per altre informazioni, vedere implementazione di callback client senza postback.For more information, see Implementing Client Callbacks Without Postbacks.

Esempi di controlli che implementano ICallbackEventHandler l'interfaccia includono GridViewi DetailsViewcontrolli, TreeView e.Examples of controls that implement the ICallbackEventHandler interface include the GridView, DetailsView, and TreeView controls. Quando un evento di callback è destinato a un controllo ICallbackEventHandler che implementa l' RaiseCallbackEvent interfaccia, il metodo viene chiamato per gestire l'evento, passando l'argomento dell'evento come GetCallbackResult parametro e il metodo restituisce il risultato della richiamata.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.

I controlli che recuperano dati da un controllo origine dati durante la richiamata possono eseguire questa operazione in modo sincrono o asincrono.Controls that retrieve data from a data source control during callback can do so synchronously or asynchronously. I controlli ASP.NET GridViewcome DetailsView, e TreeView vengono implementati in modo sincrono.ASP.NET controls like GridView, DetailsView, and TreeView are implemented synchronously. I callback sincroni non impediscono all'utente di usare il browser.Synchronous callbacks do not prevent the user from working in the browser. In modalità sincrona, è possibile eseguire solo un callback alla volta, con l'ultimo callback che ha la precedenza.In synchronous mode, only one callback at a time can execute, with the last callback taking precedence. Quando un controllo Web viene implementato per supportare il comportamento asincrono, è possibile generare più callback simultaneamente.When a Web control is implemented to support asynchronous behavior, multiple callbacks can be raised simultaneously. Per informazioni dettagliate sulla programmazione asincrona, vedere modello asincrono basato su eventi (EAP).For details on asynchronous programming, see Event-based Asynchronous Pattern (EAP).

È possibile specificare se gli eventi di callback originati dall'interfaccia utente di cui viene eseguito il ICallbackEventHandler rendering da un controllo che implementa l'interfaccia vengono convalidati.You can specify whether callback events originating from the user interface rendered by a control implementing the ICallbackEventHandler interface are validated. La convalida degli eventi è un'ottima procedura di sicurezza.Validation of events is a good security practice. Tuttavia, per motivi di prestazioni è possibile disabilitarlo.However, for performance reasons you can disable it. Per controllare se la convalida degli eventi viene eseguita sugli eventi di callback enableEventValidation , impostare l'attributo della direttiva @ Page o l' enableEventValidation attributo dell' elemento pages (schema delle impostazioni ASP.NET) del file 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. Se si imposta la EnableEventValidation proprietà nel codice, impostarla Page_Init nella fase di elaborazione della pagina.If you set the EnableEventValidation property in code, set it in the Page_Init phase of page processing. Per altre informazioni sul bilanciamento dei vantaggi di sicurezza della convalida degli eventi con i relativi costi in termini di prestazioni, vedere Panoramica delle prestazioni di ASP.NET.For more information on balancing the security benefit of event validation with its performance cost, see ASP.NET Performance Overview.

Metodi

GetCallbackResult() GetCallbackResult() GetCallbackResult() GetCallbackResult()

Restituisce i risultati di un evento di callback diretto a un controllo.Returns the results of a callback event that targets a control.

RaiseCallbackEvent(String) RaiseCallbackEvent(String) RaiseCallbackEvent(String) RaiseCallbackEvent(String)

Elabora un evento di callback che ha come destinazione un controllo.Processes a callback event that targets a control.

Si applica a

Vedi anche