Partilhar via


ICallbackEventHandler Interface

Definição

Usado para indicar que um controle pode ser o destino de um evento de retorno de chamada no servidor.

public interface class ICallbackEventHandler
public interface ICallbackEventHandler
type ICallbackEventHandler = interface
Public Interface ICallbackEventHandler
Derivado

Comentários

Implemente a ICallbackEventHandler interface para qualquer controle personalizado que precise receber eventos de retorno de chamada. Para obter mais informações, consulte Implementando retornos de chamada de cliente sem postbacks.

Exemplos de controles que implementam a ICallbackEventHandler interface incluem os GridViewcontroles , DetailsViewe TreeView . Quando um evento de retorno de chamada direciona um controle que implementa a ICallbackEventHandler interface, o RaiseCallbackEvent método é chamado para manipular o evento, passando o argumento de evento como um parâmetro e o GetCallbackResult método retorna o resultado do retorno de chamada.

Os controles que recuperam dados de um controle de fonte de dados durante o retorno de chamada podem fazer isso de forma síncrona ou assíncrona. ASP.NET controles como GridView, DetailsViewe TreeView são implementados de forma síncrona. Retornos de chamada síncronos não impedem que o usuário trabalhe no navegador. No modo síncrono, apenas um retorno de chamada por vez pode ser executado, com o último retorno de chamada tendo precedência. Quando um controle da Web é implementado para dar suporte ao comportamento assíncrono, vários retornos de chamada podem ser gerados simultaneamente. Para obter detalhes sobre programação assíncrona, consulte Padrão Assíncrono baseado em evento (EAP).

Você pode especificar se os eventos de retorno de chamada provenientes da interface do usuário renderizada por um controle que implementa a ICallbackEventHandler interface são validados. A validação de eventos é uma boa prática de segurança. No entanto, por motivos de desempenho, você pode desabilitá-lo. Para controlar se a validação de eventos é executada em eventos de retorno de chamada, defina o enableEventValidation atributo da diretiva @ Page ou o enableEventValidation atributo do Elemento pages (ASP.NET Esquema de Configurações) do arquivo Web.config. Se você definir a EnableEventValidation propriedade no código, defina-a Page_Init na fase de processamento de página. Para obter mais informações sobre como equilibrar o benefício de segurança da validação de eventos com seu custo de desempenho, consulte Visão geral do desempenho ASP.NET.

Métodos

GetCallbackResult()

Retorna os resultados de um evento de retorno de chamada que segmenta um controle.

RaiseCallbackEvent(String)

Processa um evento de retorno de chamada que segmenta um controle.

Aplica-se a

Confira também