ClientScriptManager.IsStartupScriptRegistered 方法

定義

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

判斷啟動腳本是否已註冊在物件 Page 上。

多載

名稱 Description
IsStartupScriptRegistered(Type, String)

判斷啟動腳本是否以指定的金鑰與類型註冊給物件 Page 。
IsStartupScriptRegistered(String)

判斷啟動腳本是否已使用指定金鑰註冊於物件 Page 。

IsStartupScriptRegistered(Type, String)

判斷啟動腳本是否以指定的金鑰與類型註冊給物件 Page 。

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

參數

type
Type

要搜尋的啟動腳本類型。

key
String

啟動腳本的關鍵字要搜尋。

傳回

Boolean

true如果啟動腳本已註冊;否則，。 false

例外狀況

ArgumentNullException

啟動腳本類型為 null。

範例

以下程式碼範例示範了此 IsStartupScriptRegistered 方法的使用。 請注意，如果移除檢查現有啟動腳本區塊的邏輯，渲染頁面的 HTML 原始碼中就不會有兩個重複的啟動腳本，因為該 RegisterStartupScript 方法會檢查重複。 檢查的好處是減少不必要的計算。

<%@ 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 scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 scripts on the page.
    Dim csname1 As String = "PopupScript"
    Dim csname2 As String = "ButtonClickScript"
    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 startup script is already registered.
    If (Not cs.IsStartupScriptRegistered(cstype, csname1)) Then
      
      Dim cstext1 As String = "alert('Hello World');"
      cs.RegisterStartupScript(cstype, csname1, cstext1, True)
      
    End If
    
    ' Check to see if the client script is already registered.
    If (Not cs.IsClientScriptBlockRegistered(cstype, csname2)) Then
      
      Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
      cstext2.Append("Form1.Message.value='Text from client script.'} </")
      cstext2.Append("script>")
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), False)
      
    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="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>

備註

在呼叫 RegisterStartupScript 該方法之前，先呼叫此方法，以避免註冊重複腳本。 如果腳本需要大量伺服器資源來建立，這點尤其重要。

用戶端啟動腳本以其鍵與類型唯一識別。 具有相同鍵與型別的腳本被視為重複。

另請參閱

適用於

IsStartupScriptRegistered(String)

判斷啟動腳本是否已使用指定金鑰註冊於物件 Page 。

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

參數

key
String

啟動腳本的關鍵字要搜尋。

傳回

Boolean

true如果啟動腳本已註冊;否則，。 false

備註

在呼叫 RegisterStartupScript 該方法之前，先呼叫此方法，以避免註冊重複腳本。 如果腳本需要大量伺服器資源來建立，這點尤其重要。

啟動腳本以其金鑰和類型唯一識別。 具有相同鍵與型別的腳本被視為重複。

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

另請參閱

適用於