ScriptManager.RegisterStartupScript 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使用 ScriptManager 控制項註冊啟動指令碼區塊,並將指令碼區塊加入網頁中。
多載
RegisterStartupScript(Control, Type, String, String, Boolean) |
使用 UpdatePanel 控制項,為 ScriptManager 內部的某個控制項註冊啟動指令碼區塊,並將指令碼區塊加入網頁中。 |
RegisterStartupScript(Page, Type, String, String, Boolean) |
使用 ScriptManager 控制項註冊每次非同步回傳的啟動指令碼區塊,並將指令碼區塊加入網頁中。 |
RegisterStartupScript(Control, Type, String, String, Boolean)
使用 UpdatePanel 控制項,為 ScriptManager 內部的某個控制項註冊啟動指令碼區塊,並將指令碼區塊加入網頁中。
public:
static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript (System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)
參數
- control
- Control
要註冊用戶端指令碼區塊的控制項。
- type
- Type
用戶端指令碼區塊的類型。 此參數通常會透過 typeof 運算子 (C#) 或 GetType 運算子 (Visual Basic) 指定,用以擷取註冊指令碼的控制項類型。
- key
- String
指令碼區塊的唯一識別項。
- script
- String
要註冊的指令碼。
- addScriptTags
- Boolean
true
表示要使用 <script>
與 </script>
標記括住指令碼區塊;否則為 false
。
例外狀況
control
不在網頁的控制項樹狀結構中。
備註
您可以使用 RegisterStartupScript 方法來註冊與部分頁面轉譯相容的頁面啟動腳本區塊,而且沒有Microsoft Ajax 程式庫相依性。 只有在註冊區塊的控制項位於正在更新的控制項內 UpdatePanel 時,才會將使用此方法註冊的啟動腳本區區塊轉送至頁面。 若要在每次發生非同步回傳時註冊啟動腳本區塊,請使用 RegisterStartupScript(Page, Type, String, String, Boolean) 此方法的多載。
如果您想要註冊與部分頁面更新無關的啟動腳本,而且如果您想要在初始頁面轉譯期間只註冊腳本一次,請使用 RegisterStartupScript 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。
方法所 RegisterStartupScript 轉譯的腳本區塊會在頁面完成載入,但在引發頁面的用戶端 onload
事件之前執行。 啟動腳本區塊位於轉譯 ASP.NET 網頁的底部, </form>
位於標記之前。
使用 RegisterStartupScript 註冊的啟動腳本區塊不保證會以註冊的順序輸出。 如果啟動腳本區塊的順序很重要,請使用 StringBuilder 物件來收集單一字串中的腳本區塊,然後將它們全部註冊為單一啟動腳本。
另請參閱
適用於
RegisterStartupScript(Page, Type, String, String, Boolean)
使用 ScriptManager 控制項註冊每次非同步回傳的啟動指令碼區塊,並將指令碼區塊加入網頁中。
public:
static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript (System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)
參數
- page
- Page
要註冊用戶端指令碼區塊的頁面物件。
- type
- Type
用戶端指令碼區塊的類型。 此參數通常會透過 typeof 運算子 (C#) 或 GetType 運算子 (Visual Basic) 指定,用以擷取註冊指令碼的控制項類型。
- key
- String
指令碼區塊的唯一識別項。
- script
- String
要註冊的指令碼。
- addScriptTags
- Boolean
true
表示要使用 <script>
與 </script>
標記括住指令碼區塊;否則為 false
。
備註
您可以使用這個方法來註冊每次發生非同步回傳時所包含的啟動腳本區塊。 若要為控制項內的 UpdatePanel 控制項註冊腳本區塊,以便只在更新控制項時 UpdatePanel 註冊腳本區塊,請使用 RegisterStartupScript(Control, Type, String, String, Boolean) 這個方法的多載。
如果您想要註冊與部分頁面更新無關的啟動腳本,而且如果您想要在初始頁面轉譯期間只註冊腳本一次,請使用 RegisterStartupScript 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。