ICallbackEventHandler Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Используется для указания, что элемент управления может быть целевым объектом события обратного вызова на сервере.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic Interface ICallbackEventHandler- Производный
Комментарии
ICallbackEventHandler Реализуйте интерфейс для любого пользовательского элемента управления, который должен получать события обратного вызова. Дополнительные сведения см. в разделе "Реализация обратных вызовов клиента без обратной передачи".
Примеры элементов управления, реализующих ICallbackEventHandler интерфейс, включают GridViewэлементы управления и TreeViewDetailsViewэлементы управления. Когда событие обратного вызова предназначено для элемента управления, реализующего ICallbackEventHandler интерфейс, RaiseCallbackEvent метод вызывается для обработки события, передав аргумент события в качестве параметра, а GetCallbackResult метод возвращает результат обратного вызова.
Элементы управления, которые извлекают данные из элемента управления источником данных во время обратного вызова, могут выполнять это синхронно или асинхронно. ASP.NET такие элементы управления, как GridView, DetailsViewи TreeView реализуются синхронно. Синхронные обратные вызовы не препятствуют работе пользователя в браузере. В синхронном режиме одновременно может выполняться только один обратный вызов с последним приоритетом обратного вызова. При реализации веб-элемента управления для поддержки асинхронного поведения можно одновременно вызывать несколько обратных вызовов. Дополнительные сведения об асинхронном программировании см. в статье "Асинхронный шаблон на основе событий" (EAP).
Можно указать, проверяются ли события обратного вызова из пользовательского интерфейса, отображаемого элементом управления, реализующим ICallbackEventHandler интерфейс. Проверка событий является хорошей практикой безопасности. Однако по соображениям производительности его можно отключить. Чтобы контролировать, выполняется ли проверка событий при событиях обратного вызова, задайте enableEventValidation атрибут директивы @Page или enableEventValidation атрибут элемента pages (схема параметров ASP.NET) файла Web.config. Если задать EnableEventValidation свойство в коде, задайте его на Page_Init этапе обработки страниц. Дополнительные сведения о балансировке преимуществ безопасности проверки событий с ее затратами на производительность см. в ASP.NET обзор производительности.
Методы
| Имя | Описание |
|---|---|
| GetCallbackResult() |
Возвращает результаты события обратного вызова, предназначенного для элемента управления. |
| RaiseCallbackEvent(String) |
Обрабатывает событие обратного вызова, которое предназначено для элемента управления. |
