共用方式為


IExtenderControl 介面

定義

定義擴充項控制項的行為。

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

備註

衍生自 類別的 ExtenderControl 擴充項控制項需要頁面上有控制項 ScriptManagerExtenderControl基類會執行明確的測試,以確保 ScriptManager 控制項存在於頁面上。

不過,如果您想要建立擴充項控制項,而且頁面不包含 ScriptManager 控制項,您可以建立直接實作介面的 IExtenderControl 類別。 此外,如果您要建立衍生自 Control 的類別,或擴充衍生自 Control 的現有控制項,您可以實作 IExtenderControl 介面以支援用戶端功能。

介面 IExtenderControl 會藉由呼叫 GetScriptReferences 方法來註冊控制項的腳本程式庫,並藉由呼叫 GetScriptDescriptors 方法來註冊 ScriptDescriptor 物件。 方法會 GetScriptDescriptorsIEnumerable 回 物件清單 ScriptDescriptor

注意

如果您擴充衍生自 WebControl 類別的現有控制項類型,請實作 IScriptControl 介面。

若要藉由實 IExtenderControl 作 來建立擴充項控制項,請執行下列動作:

  • 撰寫控制項 OnInit 事件的程式碼,以偵測並使用控制項是否可在頁面上使用 ScriptManager

  • ScriptManager如果頁面上無法使用 ,請透過呼叫 類別的靜態方法,提供註冊必要腳本的 ScriptManager 替代方法。

  • 為成員提供受保護的虛擬成員 IExtenderControl

  • 提供實例腳本做為您向 控制項註冊的 ScriptManager 腳本區塊。 您必須在控制項的 PreRenderPreRenderCompleteRender 事件期間執行此動作。

  • 在控制項的 Render 事件期間註冊腳本描述項。

注意

如果頁面包含 UpdatePanel 控制項,則頁面必須包含 ScriptManager 控制項。 只有當頁面不包含 控制項時,您才必須實 IExtenderControlScriptManager 作 介面。

方法

GetScriptDescriptors(Control)

註冊控制項的 ScriptDescriptor 物件,並傳回包含控制項之 ScriptDescriptor 物件的物件。

GetScriptReferences()

註冊控制項的指令碼程式庫,並傳回已註冊為內嵌資源的 ECMAScript (JavaScript) 檔案列舉型別。

適用於

另請參閱