ICallbackEventHandler Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se utiliza para indicar que un control puede ser el destino de un evento de devolución de llamada en el servidor.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Derivado
Comentarios
Implemente la ICallbackEventHandler interfaz para cualquier control personalizado que necesite recibir eventos de devolución de llamada. Para obtener más información, vea Implementación de devoluciones de llamada de cliente sin postbacks.
Algunos ejemplos de controles que implementan la ICallbackEventHandler interfaz incluyen los GridViewcontroles , DetailsViewy TreeView . Cuando un evento de devolución de llamada tiene como destino un control que implementa la ICallbackEventHandler interfaz , RaiseCallbackEvent se llama al método para controlar el evento, pasando el argumento del evento como parámetro y el GetCallbackResult método devuelve el resultado de la devolución de llamada.
Los controles que recuperan datos de un control de origen de datos durante la devolución de llamada pueden hacerlo de forma sincrónica o asincrónica. ASP.NET controles como GridView, DetailsViewy TreeView se implementan de forma sincrónica. Las devoluciones de llamada sincrónicas no impiden que el usuario funcione en el explorador. En modo sincrónico, solo se puede ejecutar una devolución de llamada a la vez, con la última devolución de llamada que tiene prioridad. Cuando se implementa un control web para admitir el comportamiento asincrónico, se pueden generar simultáneamente varias devoluciones de llamada. Para obtener más información sobre la programación asincrónica, consulte Patrón asincrónico basado en eventos (EAP).
Puede especificar si se validan los eventos de devolución de llamada procedentes de la interfaz de usuario representadas por un control que implementa la ICallbackEventHandler interfaz. La validación de eventos es una buena práctica de seguridad. Sin embargo, por motivos de rendimiento, puede deshabilitarlo. Para controlar si la validación de eventos se realiza en eventos de devolución de llamada, establezca el enableEventValidation atributo de la directiva @ Page o el enableEventValidation atributo del elemento pages (ASP.NET esquema de configuración) del archivo Web.config. Si establece la EnableEventValidation propiedad en el código, establézcala en la Page_Init fase de procesamiento de páginas. Para obtener más información sobre el equilibrio de la ventaja de seguridad de la validación de eventos con su costo de rendimiento, consulte ASP.NET Información general sobre el rendimiento.
Métodos
| GetCallbackResult() |
Devuelve los resultados de un evento de devolución de llamada que tiene como destino un control. |
| RaiseCallbackEvent(String) |
Procesa un evento de devolución de llamada que tiene como destino un control. |
