ScriptManager.RegisterOnSubmitStatement 方法

  • 參考

定義

命名空間:
System.Web.UI
組件:
System.Web.Extensions.dll

註冊表單送出時所執行的 ECMAScript (JavaScript) 程式碼。

多載

RegisterOnSubmitStatement(Page, Type, String, String)

為搭配表單送出時所執行之 UpdatePanel 控制項一起使用的控制項，向 ScriptManager 控制項註冊 ECMAScript (JavaScript) 程式碼。
RegisterOnSubmitStatement(Control, Type, String, String)

為搭配表單送出時所執行之 UpdatePanel 控制項一起使用的控制項，向 ScriptManager 控制項註冊 ECMAScript (JavaScript) 程式碼。

RegisterOnSubmitStatement(Page, Type, String, String)

為搭配表單送出時所執行之 UpdatePanel 控制項一起使用的控制項，向 ScriptManager 控制項註冊 ECMAScript (JavaScript) 程式碼。

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script);
public static void RegisterOnSubmitStatement (System.Web.UI.Page page, Type type, string key, string script);
static member RegisterOnSubmitStatement : System.Web.UI.Page * Type * string * string -> unit
Public Shared Sub RegisterOnSubmitStatement (page As Page, type As Type, key As String, script As String)

參數

page
Page

要註冊 onsubmit 陳述式的頁面物件。

type
Type

用戶端指令碼陳述式的類型。 此參數通常會透過 typeof 運算子 (C#) 或 GetType 運算子 (Visual Basic) 指定，用以擷取註冊指令碼的控制項類型。

key
String

指令碼陳述式的唯一識別項。

script
String

要註冊的指令碼。

例外狀況

ArgumentNullException

page 為 null。

-或- type 為 null。

備註

使用此方法註冊 JavaScript 程式碼會導致每次發生非同步回傳時包含腳本。

注意

不會移除任何先前非同步回傳的程式碼。 新的非同步回傳會將程式碼附加至 語句的任何現有程式 onsubmit 代碼。

若要為控制項內的 UpdatePanel 控制項註冊程式碼，以便只在更新控制項時 UpdatePanel 註冊程式碼，請使用 RegisterOnSubmitStatement(Control, Type, String, String) 這個方法的多載。

如果您想要註冊與部分頁面更新無關的 JavaScript 程式碼，而且如果您想要在初始頁面轉譯期間只註冊程式碼一次，請使用 RegisterOnSubmitStatement 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。

另請參閱

適用於

RegisterOnSubmitStatement(Control, Type, String, String)

為搭配表單送出時所執行之 UpdatePanel 控制項一起使用的控制項，向 ScriptManager 控制項註冊 ECMAScript (JavaScript) 程式碼。

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script);
public static void RegisterOnSubmitStatement (System.Web.UI.Control control, Type type, string key, string script);
static member RegisterOnSubmitStatement : System.Web.UI.Control * Type * string * string -> unit
Public Shared Sub RegisterOnSubmitStatement (control As Control, type As Type, key As String, script As String)

參數

control
Control

要註冊 onsubmit 陳述式的控制項。

type
Type

用戶端指令碼陳述式的類型。 此參數通常會透過 typeof 運算子 (C#) 或 GetType 運算子 (Visual Basic) 指定，用以擷取註冊指令碼的控制項類型。

key
String

指令碼陳述式的唯一識別項。

script
String

要註冊的指令碼。

例外狀況

ArgumentNullException

control 為 null。

-或- type 為 null。

ArgumentException

control 不在網頁的控制項樹狀結構中。

備註

會在 RegisterOnSubmitStatement 提交表單之前執行的新增腳本，可讓您修改提交或取消它。

您可以使用 RegisterOnSubmitStatement 方法來轉 onsubmit 譯與部分頁面轉譯相容的語句，而且沒有 Microsoft Ajax Library 相依性。 只有在註冊 語句的控制項位於正在更新的控制項內 UpdatePanel 時，才會將使用這個方法註冊的 JavaScript 程式碼傳送至頁面。 若要向每個非同步回傳註冊程式碼，請使用 RegisterOnSubmitStatement(Page, Type, String, String) 此方法的多載。

如果您想要註冊與部分頁面更新無關的 JavaScript 程式碼，而且如果您想要在初始頁面轉譯期間只註冊程式碼一次，請使用 RegisterOnSubmitStatement 類別的 ClientScriptManager 方法。 您可以從頁面的 屬性取得 物件的 ClientScript 參考 ClientScriptManager 。

方法的 RegisterOnSubmitStatement script 參數可以包含多個使用分號 (;) 分隔的指令碼命令。

如需 HTML 表單和 onsubmit 事件的詳細資訊，請參閱 World Wide Web Consortium (W3C) 網站。

另請參閱

適用於