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)

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

適用於

另請參閱