IExtenderControl インターフェイス

  • リファレンス

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.Extensions.dll

エクステンダー コントロールの動作を定義します。

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

注釈

クラスから派生したエクステンダー コントロールには ExtenderControl 、コントロールが ScriptManager ページ上に存在する必要があります。 基本クラスは ExtenderControl 、明示的なテストを実行して、 ScriptManager コントロールがページに存在することを確認します。

ただし、エクステンダー コントロールを作成し、ページにコントロールが含 ScriptManager まれていない場合は、インターフェイスを直接実装するクラスを IExtenderControl 作成できます。 さらに、 から派生するクラスを作成する場合、または から Control 派生した既存のコントロール Controlを拡張する場合は、 インターフェイスを IExtenderControl 実装してクライアント機能をサポートできます。

インターフェイスはIExtenderControl、 メソッドを呼び出してコントロールのスクリプト ライブラリを登録し、 メソッドをGetScriptReferencesScriptDescriptor呼び出してオブジェクトをGetScriptDescriptors登録します。 メソッドはGetScriptDescriptors、オブジェクトのScriptDescriptor一覧をIEnumerable返します。

注意

クラスから WebControl 派生した既存のコントロール型を拡張する場合は、 インターフェイスを実装します IScriptControl 。

を実装 IExtenderControlしてエクステンダー コントロールを作成するには、次の操作を行います。

  • コントロールがページで使用可能な場合は、コントロールの OnInit イベントを ScriptManager 検出して使用するためのコードを記述します。

  • ScriptManagerがページで使用できない場合は、 クラスの静的メソッドを呼び出して、必要なスクリプトを登録する別の手段をScriptManager指定します。

  • メンバーに保護された仮想メンバーを提供します IExtenderControl 。

  • インスタンス スクリプトを、コントロールに登録 ScriptManager するスクリプト ブロックとして指定します。 これは、コントロールの 、PreRenderComplete、または Render イベント中PreRenderに行う必要があります。

  • コントロール Render のイベント中にスクリプト記述子を登録します。

注意

ページにコントロールが含まれている UpdatePanel 場合、ページにはコントロールが ScriptManager 含まれている必要があります。 インターフェイスは、ページに IExtenderControl コントロールが含まれていない場合にのみ実装する ScriptManager 必要があります。

メソッド

GetScriptDescriptors(Control)

コントロールの ScriptDescriptor オブジェクトを登録し、コントロールの ScriptDescriptor オブジェクトを格納しているオブジェクトを返します。
GetScriptReferences()

コントロールのスクリプト ライブラリを登録し、埋め込みリソースとして登録された ECMAScript (JavaScript) ファイルの列挙体を返します。

適用対象

こちらもご覧ください