通过

ICallbackEventHandler 接口

  • 参考

定义

命名空间:
System.Web.UI
程序集:
System.Web.dll

用于指示控件可以作为服务器上的回调事件的目标。

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 ）是同步实现的。 同步回调不会阻止用户在浏览器中工作。 在同步模式下，一次只能执行一个回调，最后一个回调优先。 实现 Web 控件以支持异步行为时，可以同时引发多个回调。 有关异步编程的详细信息，请参阅 基于事件的异步模式 (EAP) 。

可以指定是否验证来自实现接口的控件呈现的用户界面的 ICallbackEventHandler 回调事件。 验证事件是一种很好的安全做法。 但是，出于性能原因，可以禁用它。 若要控制是否对回调事件执行事件验证，请设置 enableEventValidation@ Page 指令的 属性或 enableEventValidationWeb.config 文件的 pages Element (ASP.NET Settings 架构) 的 属性。 如果在代码中设置 EnableEventValidation 属性，请在页面处理阶段对其进行 Page_Init 设置。 有关平衡事件验证的安全优势及其性能成本的详细信息，请参阅 ASP.NET 性能概述。

方法

GetCallbackResult()

返回以控件为目标的回调事件的结果。
RaiseCallbackEvent(String)

处理以控件为目标的回调事件。

适用于

另请参阅