Share via

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 方法。 可以从页面的 ClientScriptManager 属性获取对 对象的 ClientScript 引用。

另请参阅

适用于

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 库依赖项的语句。 仅当注册语句的控件位于正在更新的控件内 UpdatePanel 时，使用此方法注册的 JavaScript 代码才会发送到页面。 若要向每个异步回发注册代码，请使用 RegisterOnSubmitStatement(Page, Type, String, String) 此方法的 重载。

如果要注册与部分页面更新无关的 JavaScript 代码，并且希望在初始页面呈现期间只注册代码一次，请使用 RegisterOnSubmitStatement 类的 ClientScriptManager 方法。 可以从页面的 ClientScriptManager 属性获取对 对象的 ClientScript 引用。

方法的 RegisterOnSubmitStatementscript 参数可以包含多个使用分号 (;) 分隔的脚本命令。

有关 HTML 表单和 onsubmit 事件的详细信息，请参阅 万维网联合会 (W3C) 网站。

另请参阅

适用于