IExtenderControl 介面

定義

命名空間:

System.Web.UI

組件:

System.Web.Extensions.dll

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

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

衍生

System.Web.UI.ExtenderControl

備註

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

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

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

注意

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

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

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

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

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

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

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

注意

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

方法

GetScriptDescriptors(Control)	註冊控制項的 ScriptDescriptor 物件，並傳回包含控制項之 ScriptDescriptor 物件的物件。
GetScriptReferences()	註冊控制項的指令碼程式庫，並傳回已註冊為內嵌資源的 ECMAScript (JavaScript) 檔案列舉型別。

另請參閱

• ExtenderControl
• ScriptManager