ICallbackEventHandler Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Viene utilizzata per indicare che un controllo può essere la destinazione di un evento di callback sul server.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Derivato
Commenti
Implementare l'interfaccia ICallbackEventHandler per qualsiasi controllo personalizzato che deve ricevere eventi di callback. Per altre informazioni, vedere Implementazione dei callback client senza postback.
Esempi di controlli che implementano l'interfaccia ICallbackEventHandler includono i GridViewcontrolli , DetailsViewe TreeView . Quando un evento di callback è destinato a un controllo che implementa l'interfaccia ICallbackEventHandler , il RaiseCallbackEvent metodo viene chiamato per gestire l'evento, passando l'argomento evento come parametro e il GetCallbackResult metodo restituisce il risultato del callback.
I controlli che recuperano dati da un controllo origine dati durante il callback possono farlo in modo sincrono o asincrono. ASP.NET controlli come GridView, DetailsViewe TreeView vengono implementati in modo sincrono. I callback sincroni non impediscono all'utente di lavorare nel browser. In modalità sincrona è possibile eseguire un solo callback alla volta, con l'ultimo callback che ha la precedenza. Quando un controllo Web viene implementato per supportare il comportamento asincrono, possono essere generati più callback contemporaneamente. Per informazioni dettagliate sulla programmazione asincrona, vedere Modello asincrono basato su eventi (EAP).
È possibile specificare se gli eventi di callback provenienti dall'interfaccia utente sottoposti a rendering da un controllo che implementa l'interfaccia ICallbackEventHandler vengono convalidati. La convalida degli eventi è una buona procedura di sicurezza. Tuttavia, per motivi di prestazioni è possibile disabilitarlo. Per controllare se la convalida degli eventi viene eseguita sugli eventi di callback, impostare l'attributo enableEventValidation della direttiva @ Page o l'attributo enableEventValidationdell'elemento pages (schema delle impostazioni ASP.NET) del file Web.config. Se si imposta la EnableEventValidation proprietà nel codice, impostarla nella Page_Init fase di elaborazione della pagina. Per altre informazioni sul bilanciamento del vantaggio di sicurezza della convalida degli eventi con il relativo costo delle prestazioni, vedere ASP.NET Panoramica delle prestazioni.
Metodi
| GetCallbackResult() |
Restituisce i risultati di un evento di callback diretto a un controllo. |
| RaiseCallbackEvent(String) |
Elabora un evento di callback che ha come destinazione un controllo. |
