ScriptManager.RegisterOnSubmitStatement 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
註冊表單送出時所執行的 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
要註冊的指令碼。
例外狀況
備註
使用此方法註冊 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
要註冊的指令碼。
例外狀況
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) 網站。