共用方式為

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、 DetailsView和 TreeView 之類的GridView控制項會同步實作。 同步回呼不會防止使用者在瀏覽器中運作。 在同步模式中，一次只能執行一個回呼，最後一個回呼優先。 實作 Web 控制件以支援異步行為時，可以同時引發多個回呼。 如需異步程式設計的詳細資訊，請參閱 事件架構異步模式 (EAP) 。

您可以指定回呼事件是否源自實作介面之控件 ICallbackEventHandler 所呈現的使用者介面進行驗證。 事件驗證是很好的安全性做法。 不過，基於效能考慮，您可以將其停用。 若要控制是否在回呼事件上執行事件驗證，請設定 enableEventValidation@ Page 指示詞的屬性或 enableEventValidationpages 元素的 屬性， (ASP.NET 設定架構) Web.config 檔案。 如果您在程式代碼中設定 EnableEventValidation 屬性，請在頁面處理階段加以 Page_Init 設定。 如需平衡事件驗證的安全性優點及其效能成本的詳細資訊，請參閱 ASP.NET 效能概觀。

方法

GetCallbackResult()

傳回以控制項為目標之回呼事件的結果。
RaiseCallbackEvent(String)

處理以控制項為目標的回呼事件。

適用於

另請參閱