次の方法で共有


ICallbackEventHandler インターフェイス

定義

コントロールをサーバー上のコールバック イベントの対象にできることを示すために使用します。

public interface class ICallbackEventHandler
public interface ICallbackEventHandler
type ICallbackEventHandler = interface
Public Interface ICallbackEventHandler
派生

注釈

コールバック イベントを ICallbackEventHandler 受信する必要があるカスタム コントロールのインターフェイスを実装します。 詳細については、「 ポストバックなしのクライアント コールバックの実装」を参照してください。

インターフェイスを実装ICallbackEventHandlerするコントロールの例としては、 GridViewDetailsViewTreeView コントロールなどがあります。 コールバック イベントが インターフェイスを実装 ICallbackEventHandler するコントロールを対象とする場合、イベントを RaiseCallbackEvent 処理するために メソッドが呼び出され、イベント引数がパラメーターとして渡され、 GetCallbackResult メソッドはコールバックの結果を返します。

コールバック中にデータ ソース コントロールからデータを取得するコントロールは、同期的または非同期的に行うことができます。 、 などの GridViewDetailsViewTreeView ASP.NET コントロールは同期的に実装されます。 同期コールバックを使用すると、ユーザーがブラウザーで作業できなくなります。 同期モードでは、一度に 1 つのコールバックのみを実行でき、最後のコールバックが優先されます。 非同期動作をサポートするために Web コントロールが実装されている場合、複数のコールバックを同時に発生させることができます。 非同期プログラミングの詳細については、「 イベント ベースの非同期パターン (EAP)」を参照してください。

インターフェイスを実装するコントロールによってレンダリングされたユーザー インターフェイスから発生したコールバック イベントを ICallbackEventHandler 検証するかどうかを指定できます。 イベントの検証は、セキュリティ上の優れた方法です。 ただし、パフォーマンス上の理由から、無効にすることができます。 コールバック イベントに対してイベント検証を実行するかどうかを制御するには、enableEventValidation@ Page ディレクティブの属性または enableEventValidation Web.config ファイルの pages 要素 (ASP.NET 設定スキーマ) の属性を設定します。 コードで プロパティを設定する EnableEventValidation 場合は、ページ処理のフェーズで Page_Init 設定します。 イベント検証のセキュリティ上の利点とパフォーマンス コストのバランスを取る方法の詳細については、「 ASP.NET パフォーマンスの概要」を参照してください。

メソッド

GetCallbackResult()

コントロールを対象とするコールバック イベントの結果を返します。

RaiseCallbackEvent(String)

コントロールを対象とするコールバック イベントを処理します。

適用対象

こちらもご覧ください