語言

ScriptManager.RegisterOnSubmitStatement 方法

定義

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

註冊 ECMAScript（JavaScript）程式碼，並在表單提交時執行。

多載

名稱 Description
RegisterOnSubmitStatement(Page, Type, String, String)

將 ECMAScript（JavaScript）程式碼註冊為 ScriptManager 控制項，該控制項在 UpdatePanel 提交表單時執行。
RegisterOnSubmitStatement(Control, Type, String, String)

將 ECMAScript（JavaScript）程式碼註冊為 ScriptManager 控制項，該控制項在 UpdatePanel 提交表單時執行。

RegisterOnSubmitStatement(Page, Type, String, String)

將 ECMAScript（JavaScript）程式碼註冊為 ScriptManager 控制項，該控制項在 UpdatePanel 提交表單時執行。

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 程式碼，會使每次非同步回傳時都包含該腳本。

Note

任何早期非同步回貼的程式碼都不會被移除。 新的非同步回傳會將程式碼附加到任何現有的語句程式碼 onsubmit 上。

若要註冊控制項內 UpdatePanel 的程式碼，使程式碼僅在控制項更新時 UpdatePanel 註冊，請使用此方法的 RegisterOnSubmitStatement(Control, Type, String, String) 超載功能。

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

另請參閱

適用於

RegisterOnSubmitStatement(Control, Type, String, String)

將 ECMAScript（JavaScript）程式碼註冊為 ScriptManager 控制項，該控制項在 UpdatePanel 提交表單時執行。

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 函式庫依賴的語句。 使用此方法註冊的 JavaScript 程式碼，只有當註冊該語句的控制項位於正在更新的控制項中 UpdatePanel 時，才會被傳送到頁面。 若要在每個非同步回傳中註冊程式碼，請使用此方法的 RegisterOnSubmitStatement(Page, Type, String, String) 超載功能。

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

該方法的RegisterOnSubmitStatement參數可包含多個腳本指令，並以分號（;) 來分隔。

欲了解更多關於 HTML 表單及活動的 onsubmit 資訊，請參閱 萬維網聯盟（W3C）網站。

另請參閱

適用於