ICallbackEventHandler インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コントロールをサーバー上のコールバック イベントの対象にできることを示すために使用します。
public interface class ICallbackEventHandlerpublic interface ICallbackEventHandlertype ICallbackEventHandler = interfacePublic 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) |
コントロールを対象とするコールバック イベントを処理します。 |
適用対象
こちらもご覧ください
.NET