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' ICallbackEventHandler interface pour tout contrôle personnalisé qui doit recevoir des événements de rappel. Pour plus d’informations, consultez implémentation de rappels clients sans publication (postback).
Les contrôles, et sont des exemples de contrôles qui implémentent l' ICallbackEventHandler interface GridView DetailsView TreeView . Lorsqu’un événement de rappel cible un contrôle qui implémente l' ICallbackEventHandler interface, la RaiseCallbackEvent méthode est appelée pour gérer l’événement, 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 à partir d’un contrôle de source de données pendant le rappel peuvent le faire de manière synchrone ou asynchrone. Les contrôles ASP.NET comme GridView , DetailsView et TreeView sont implémentés de façon 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 restitués par un contrôle qui implémente l' ICallbackEventHandler interface 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 d’événement est effectuée sur les événements de rappel, définissez l' enableEventValidation attribut de la directive @ page ou l' enableEventValidation attribut de l' élément pages (schéma des paramètres ASP.net) du fichier Web.config. Si vous définissez la EnableEventValidation propriété dans le code, définissez-la dans la Page_Init phase de traitement de la page. Pour plus d’informations sur l’équilibre entre l’avantage de sécurité de la validation d’événement et son coût de performance, consultez vue d’ensemble des performances ASP.net.
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. |