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 方法。 可以从页面的 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
要注册的脚本。
例外
control
不在该页面的控件树中。
注解
添加 RegisterOnSubmitStatement 在提交表单之前执行的脚本,以便修改或取消提交。
使用 RegisterOnSubmitStatement 方法可呈现onsubmit
与部分页面呈现兼容且没有Microsoft Ajax 库依赖项的语句。 仅当注册语句的控件位于正在更新的控件内 UpdatePanel 时,使用此方法注册的 JavaScript 代码才会发送到页面。 若要向每个异步回发注册代码,请使用 RegisterOnSubmitStatement(Page, Type, String, String) 此方法的 重载。
如果要注册与部分页面更新无关的 JavaScript 代码,并且希望在初始页面呈现期间只注册代码一次,请使用 RegisterOnSubmitStatement 类的 ClientScriptManager 方法。 可以从页面的 ClientScriptManager 属性获取对 对象的 ClientScript 引用。
方法的 RegisterOnSubmitStatementscript 参数可以包含多个使用分号 (;) 分隔的脚本命令。
有关 HTML 表单和 onsubmit
事件的详细信息,请参阅 万维网联合会 (W3C) 网站。