ClientScriptManager.IsOnSubmitStatementRegistered 方法

定義

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

判斷 OnSubmit 陳述是否已註冊於物件 Page 。

多載

名稱 Description
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

true如果 OnSubmit 陳述式被註冊;否則，。 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

true如果 OnSubmit 陳述式被註冊;否則，。 false

備註

在呼叫 RegisterOnSubmitStatement 此方法之前，請先呼叫此方法，以避免重複註冊 OnSubmit 陳述句。 如果該語句需要大量伺服器資源來建立，這點尤其重要。

語句以其鍵與類型唯一識別。 具有相同鍵與型別的語句被視為重複。

此方法的超載 IsOnSubmitStatementRegistered 會呼叫一個同時取 a key 與 type 參數的超載，且該 Page 參數設為物件型別

另請參閱

適用於