ClientScriptManager.IsOnSubmitStatementRegistered 方法

  • 參考

定義

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

判斷 OnSubmit 陳述式是否向 Page 物件註冊過。

多載

IsOnSubmitStatementRegistered(Type, String)

判斷 OnSubmit 陳述式是否已使用指定的索引鍵和類型，向 Page 物件註冊。
IsOnSubmitStatementRegistered(String)

判斷 OnSubmit 陳述式是否已使用指定的索引鍵，向 Page 物件註冊。

IsOnSubmitStatementRegistered(Type, String)

判斷 OnSubmit 陳述式是否已使用指定的索引鍵和類型，向 Page 物件註冊。

public:
 bool IsOnSubmitStatementRegistered(Type ^ type, System::String ^ key);
public bool IsOnSubmitStatementRegistered (Type type, string key);
member this.IsOnSubmitStatementRegistered : Type * string -> bool
Public Function IsOnSubmitStatementRegistered (type As Type, key As String) As Boolean

參數

type
Type

要搜尋的 OnSubmit 陳述式類型。

key
String

要搜尋的 OnSubmit 陳述式索引鍵。

傳回

Boolean

如果 OnSubmit 陳述式已註冊，則為 true，否則為 false。

例外狀況

ArgumentNullException

OnSubmit 陳述式類型為 null。

範例

下列程式碼範例示範 如何使用 IsOnSubmitStatementRegistered 方法。 名為 OnSubmitScript 的腳本會向 Page 註冊，以便在提交頁面的表單時叫用腳本。

<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <input type="submit"
            value="Submit" />
     </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Define the name and type of the client script on the page.
    Dim csname As String = "OnSubmitScript"
    Dim cstype As Type = Me.GetType()
    
    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Check to see if the OnSubmit statement is already registered.
    If (Not cs.IsOnSubmitStatementRegistered(cstype, csname)) Then
      
      Dim cstext As String = "document.write('Text from OnSubmit statement.');"
      cs.RegisterOnSubmitStatement(cstype, csname, cstext)
      
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <input type="submit"
            value="Submit" />
     </form>
  </body>
</html>

備註

呼叫 方法之前先呼叫 RegisterOnSubmitStatement 這個方法，以避免註冊重複的語句。 如果 語句需要大量伺服器資源才能建立，這特別重要。

語句是由其索引鍵和其類型唯一識別。 具有相同索引鍵和類型的語句會被視為重複專案。 您可以根據將存取資源的物件來指定型別。 例如，使用 Page 實例來存取資源時，您可以指定 Page 類型。

另請參閱

適用於

IsOnSubmitStatementRegistered(String)

判斷 OnSubmit 陳述式是否已使用指定的索引鍵，向 Page 物件註冊。

public:
 bool IsOnSubmitStatementRegistered(System::String ^ key);
public bool IsOnSubmitStatementRegistered (string key);
member this.IsOnSubmitStatementRegistered : string -> bool
Public Function IsOnSubmitStatementRegistered (key As String) As Boolean

參數

key
String

要搜尋的 OnSubmit 陳述式索引鍵。

傳回

Boolean

如果 OnSubmit 陳述式已註冊，則為 true，否則為 false。

備註

呼叫 方法之前先呼叫 RegisterOnSubmitStatement 這個方法，以避免註冊重複的 OnSubmit 語句。 如果 語句需要大量伺服器資源才能建立，這特別重要。

語句是由其索引鍵和其類型唯一識別。 具有相同索引鍵和類型的語句會被視為重複專案。

此方法的 IsOnSubmitStatementRegistered 這個多載會呼叫多載，該多載會 key 採用 和 type 參數，並將類型設定為 Page 物件

另請參閱

適用於