ICallbackEventHandler Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Utilisé pour indiquer qu'un contrôle peut être la cible d'un événement de rappel sur le serveur.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Dérivé
Remarques
Implémentez l’interface ICallbackEventHandler pour tout contrôle personnalisé qui doit recevoir des événements de rappel. Pour plus d’informations, consultez Implémentation de rappels de client sans publication.
Les contrôles , et sont des exemples de contrôles qui implémentent l’interface ICallbackEventHandlerGridView.TreeViewDetailsView Lorsqu’un événement de rappel cible un contrôle qui implémente l’interface ICallbackEventHandler , la RaiseCallbackEvent méthode est appelée pour gérer l’événement, en passant l’argument d’événement en tant que paramètre et la GetCallbackResult méthode retourne le résultat du rappel.
Les contrôles qui récupèrent des données d’un contrôle de source de données pendant le rappel peuvent le faire de manière synchrone ou asynchrone. ASP.NET contrôles tels que GridView, DetailsViewet TreeView sont implémentés de manière synchrone. Les rappels synchrones n’empêchent pas l’utilisateur de travailler dans le navigateur. En mode synchrone, un seul rappel à la fois peut s’exécuter, le dernier rappel étant prioritaire. Lorsqu’un contrôle Web est implémenté pour prendre en charge le comportement asynchrone, plusieurs rappels peuvent être déclenchés simultanément. Pour plus d’informations sur la programmation asynchrone, consultez Modèle asynchrone basé sur les événements (EAP).
Vous pouvez spécifier si les événements de rappel provenant de l’interface utilisateur rendus par un contrôle implémentant l’interface ICallbackEventHandler sont validés. La validation des événements est une bonne pratique de sécurité. Toutefois, pour des raisons de performances, vous pouvez le désactiver. Pour contrôler si la validation des événements est effectuée sur les événements de rappel, définissez l’attribut enableEventValidation de la directive @ Page ou l’attribut enableEventValidation de l’élément pages (ASP.NET schéma des paramètres) du fichier Web.config. Si vous définissez la propriété dans le EnableEventValidation code, définissez-la dans la Page_Init phase de traitement de page. Pour plus d’informations sur l’équilibre entre l’avantage de sécurité de la validation des événements et son coût de performances, consultez ASP.NET Vue d’ensemble des performances.
Méthodes
| GetCallbackResult() |
Retourne le résultat d'un événement de rappel qui cible un contrôle. |
| RaiseCallbackEvent(String) |
Traite un événement de rappel qui cible un contrôle. |
