ClientScriptManager.RegisterOnSubmitStatement 方法

ClientScriptManager.RegisterOnSubmitStatement 方法：使用类型、键和脚本文本向Page对象注册OnSubmit语句。该语句在提交HtmlForm时执行。

命名空间: System.Web.UI
程序集: System.Web（在 system.web.dll 中）

public void RegisterOnSubmitStatement (Type type,string key,string script)

参数

type ：要注册的 OnSubmit 语句的类型。
key ：要注册的 OnSubmit 语句的键。
script ：要注册的 OnSubmit 语句的脚本文本。

OnSubmit 语句由它的键和类型唯一标识。具有相同的键和类型的语句被视为重复语句。只有一个具有给定的类型和键对的语句可向该页面注册。试图注册一个已经注册的语句不会创建重复的语句。调用 IsOnSubmitStatementRegistered 方法可确定某 OnSubmit 语句是否已通过给定的键/类型对注册，从而避免不必要地添加脚本的尝试。

RegisterOnSubmitStatement 方法的 script 参数可以包含多个脚本命令，只要它们以分号 (;) 正确地分隔。
RegisterOnSubmitStatement 添加一个脚本，该脚本在页面提交前执行并提供取消提交的机会。

下面的代码示例演示 RegisterOnSubmitStatement 方法的用法：

<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  public void Page_Load(Object sender, EventArgs e)
  {
    // Define the name and type of the client script on the page.
    String csname = "OnSubmitScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the OnSubmit statement is already registered.
    if (!cs.IsOnSubmitStatementRegistered(cstype, csname))
    {
      String cstext = "document.write('Text from OnSubmit statement');";
      cs.RegisterOnSubmitStatement(cstype, csname, cstext);
    }
  }
</script>
<html  >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <input type="submit" value="Submit" />
     </form>
  </body>
</html>


版本信息：

posted on 2008-07-05 13:58  王丹小筑  阅读(817)  评论(0)    收藏  举报

导航