ICallbackEventHandler ICallbackEventHandler ICallbackEventHandler ICallbackEventHandler Interface

Definición

Se utiliza para indicar que un control puede ser el destino de un evento de devolución de llamada en el servidor.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
Derivado

Comentarios

Implemente ICallbackEventHandler la interfaz para cualquier control personalizado que necesite recibir eventos de devolución de llamada.Implement the ICallbackEventHandler interface for any custom control that needs to receive callback events. Para obtener más información, vea implementar devoluciones de llamada de cliente sindevoluciones.For more information, see Implementing Client Callbacks Without Postbacks.

Entre los ejemplos de controles que ICallbackEventHandler implementan la GridViewinterfaz se incluyen TreeView los controles, DetailsViewy.Examples of controls that implement the ICallbackEventHandler interface include the GridView, DetailsView, and TreeView controls. Cuando un evento de devolución de llamada se dirige a un ICallbackEventHandler control que implementa RaiseCallbackEvent la interfaz, se llama al método para controlar el evento, pasando el argumento de evento GetCallbackResult como un parámetro y el método devuelve el resultado de la devolución de llamada.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.

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.Controls that retrieve data from a data source control during callback can do so synchronously or asynchronously. Los controles ASP.net GridViewcomo DetailsView, y TreeView se implementan de forma sincrónica.ASP.NET controls like GridView, DetailsView, and TreeView are implemented synchronously. Las devoluciones de llamada sincrónicas no impiden que el usuario funcione en el explorador.Synchronous callbacks do not prevent the user from working in the browser. En modo sincrónico, solo se puede ejecutar una devolución de llamada a la vez, con la prioridad de la última devolución de llamada.In synchronous mode, only one callback at a time can execute, with the last callback taking precedence. Cuando se implementa un control Web para admitir el comportamiento asincrónico, se pueden generar varias devoluciones de llamada simultáneamente.When a Web control is implemented to support asynchronous behavior, multiple callbacks can be raised simultaneously. Para obtener información detallada sobre la programación asincrónica, vea patrón asincrónico basado en eventos (EAP).For details on asynchronous programming, see Event-based Asynchronous Pattern (EAP).

Puede especificar si se validan los eventos de devolución de llamada que se originan en la interfaz ICallbackEventHandler de usuario que representa un control que implementa la interfaz.You can specify whether callback events originating from the user interface rendered by a control implementing the ICallbackEventHandler interface are validated. La validación de eventos es una práctica recomendada de seguridad.Validation of events is a good security practice. Sin embargo, por motivos de rendimiento, puede deshabilitarlo.However, for performance reasons you can disable it. Para controlar si se realiza la validación de eventos en los eventos de enableEventValidation devolución de llamada, establezca el atributo de enableEventValidation la directiva @ Page o el atributo del elemento Pages (ASP.NET Settings Schema) del archivo 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. Si establece la EnableEventValidation propiedad en el código, establézcala en la Page_Init fase de procesamiento de páginas.If you set the EnableEventValidation property in code, set it in the Page_Init phase of page processing. Para obtener más información sobre cómo equilibrar la ventaja de seguridad de la validación de eventos con el costo de rendimiento, consulte ASP.net performance Overview.For more information on balancing the security benefit of event validation with its performance cost, see ASP.NET Performance Overview.

Métodos

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

Devuelve los resultados de un evento de devolución de llamada que tiene como destino un control.Returns the results of a callback event that targets a control.

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

Procesa un evento de devolución de llamada que tiene como destino un control.Processes a callback event that targets a control.

Se aplica a

Consulte también: