Поделиться через


ICallbackEventHandler Интерфейс

Определение

Указывает, что элемент управления может быть целевым объектом события обратного вызова на сервере.

public interface class ICallbackEventHandler
public interface ICallbackEventHandler
type ICallbackEventHandler = interface
Public Interface ICallbackEventHandler
Производный

Комментарии

ICallbackEventHandler Реализуйте интерфейс для любого пользовательского элемента управления, который должен принимать события обратного вызова. Дополнительные сведения см. в разделе Реализация обратных вызовов клиента без обратной передачи.

Примеры элементов управления, реализующих ICallbackEventHandler интерфейс , включают GridViewэлементы управления , DetailsViewи TreeView . Когда событие обратного вызова предназначено для элемента управления, реализующего ICallbackEventHandler интерфейс , RaiseCallbackEvent вызывается метод для обработки события, передавая аргумент события в качестве параметра, а GetCallbackResult метод возвращает результат обратного вызова.

Элементы управления, извлекающие данные из элемента управления источником данных во время обратного вызова, могут делать это синхронно или асинхронно. ASP.NET элементы управления, такие как GridView, DetailsViewи TreeView , реализуются синхронно. Синхронные обратные вызовы не препятствуют работе пользователя в браузере. В синхронном режиме может выполняться только один обратный вызов за раз, при этом приоритет имеет последний обратный вызов. При реализации веб-элемента управления для поддержки асинхронного поведения можно одновременно вызывать несколько обратных вызовов. Дополнительные сведения об асинхронном программировании см. в разделе Асинхронная модель на основе событий (EAP).

Можно указать, проверяются ли события обратного вызова, исходящие из пользовательского интерфейса, отображаемого элементом управления, ICallbackEventHandler реализующим интерфейс. Проверка событий является хорошей практикой безопасности. Однако из соображений производительности его можно отключить. Чтобы указать, выполняется ли проверка событий для событий обратного вызова, задайте enableEventValidation атрибут директивы @ Page или enableEventValidation атрибут элемента pages (ASP.NET Settings Schema) файла Web.config. Если вы задали EnableEventValidation свойство в коде, задайте его на Page_Init этапе обработки страницы. Дополнительные сведения о балансировке преимущества безопасности проверки событий с затратами на производительность см. в статье Общие сведения о производительности ASP.NET.

Методы

GetCallbackResult()

Возвращает результаты события обратного вызова, предназначенного для элемента управления.

RaiseCallbackEvent(String)

Обработка события обратного вызова, предназначенного для элемента управления.

Применяется к

См. также раздел