ICallbackEventHandler Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Usado para indicar que um controle pode ser o destino de um evento de retorno de chamada no servidor.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic 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 do cliente sem postbacks.
Exemplos de controles que implementam a ICallbackEventHandler interface incluem GridView os DetailsView controles, e TreeView . Quando um evento de retorno de chamada é direcionado a um controle que implementa a ICallbackEventHandler interface, o RaiseCallbackEvent método é chamado para manipular o evento, passando o argumento do 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 da fonte de dados durante o retorno de chamada podem fazer isso de forma síncrona ou assíncrona. Controles ASP.NET como GridView , DetailsView e TreeView são implementados de forma síncrona. Os retornos de chamada síncronos não impedem que o usuário trabalhe no navegador. No modo síncrono, somente 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 a 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 renderizados 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 evento é executada em eventos de retorno de chamada, defina o enableEventValidation atributo da diretiva @ Page ou o enableEventValidation atributo do elemento pages (esquema de configurações ASP.net) do arquivo Web.config. Se você definir a EnableEventValidation propriedade no código, defina-a na Page_Init fase de processamento de página. Para obter mais informações sobre como balancear o benefício de segurança da validação de eventos com seu custo de desempenho, consulte visão geral do desempenho do 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. |