ICallbackEventHandler Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает, что элемент управления может быть целевым объектом события обратного вызова на сервере.
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic 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) |
Обработка события обратного вызова, предназначенного для элемента управления. |
