Page.IsClientScriptBlockRegistered(String) Page.IsClientScriptBlockRegistered(String) Page.IsClientScriptBlockRegistered(String) Page.IsClientScriptBlockRegistered(String) Method

定義

警告

此 API 現已淘汰。

判斷具有指定索引鍵的用戶端指令碼區塊是否已向頁面註冊。Determines whether the client script block with the specified key is registered with the page.

public:
 bool IsClientScriptBlockRegistered(System::String ^ key);
[System.Obsolete("The recommended alternative is ClientScript.IsClientScriptBlockRegistered(string key). http://go.microsoft.com/fwlink/?linkid=14202")]
public bool IsClientScriptBlockRegistered (string key);
member this.IsClientScriptBlockRegistered : string -> bool
Public Function IsClientScriptBlockRegistered (key As String) As Boolean

參數

key
String String String String

要搜尋的用戶端指令碼字串索引鍵。The string key of the client script to search for.

傳回

如果指令碼區塊已註冊,則為 true,否則為 falsetrue if the script block is registered; otherwise, false.

範例

下列程式碼範例示範如何搭配使用RegisterClientScriptBlock方法IsClientScriptBlockRegistered與方法。The following code example demonstrates the use of the RegisterClientScriptBlock method in conjunction with the IsClientScriptBlockRegistered method. 如果程式碼宣告區塊中所撰寫的 ECMAScript 尚未由IsClientScriptBlockRegistered決定, RegisterClientScriptBlock則會進行呼叫。If the ECMAScript written in the code declaration block has not already been registered, as determined by IsClientScriptBlockRegistered, then a RegisterClientScriptBlock call is made.

<%@ 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)
  {
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";

    if (!IsClientScriptBlockRegistered(csname1))
    {
        String cstext1 = "<script type=\"text/javascript\">" +
            "alert('Hello World');</" + "script>";
        RegisterStartupScript(csname1, cstext1);
    }

    if (!IsClientScriptBlockRegistered(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>");
      RegisterClientScriptBlock(csname2, cstext2.ToString());
    }
  }
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock 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 EventArgs)
        Dim csname1 As String = "PopupScript"

        Dim csname2 As String = "ButtonClickScript"
    
        If Not IsClientScriptBlockRegistered(csname1) Then
            Dim cstext1 As String = "<script type=""text/javascript"">" & _
                "alert('Hello World');</" & "script>"
            RegisterStartupScript(csname1, cstext1)
        End If
    
        If Not IsClientScriptBlockRegistered(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>")
            RegisterClientScriptBlock(csname2, cstext2.ToString())
        End If
    End Sub
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock 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.RegisterClientScriptBlock之前呼叫這個方法,以避免不必要地組合用戶端腳本。Call this method before calling Page.RegisterClientScriptBlock to avoid unnecessarily assembling the client-side script. 如果腳本需要大量的伺服器資源來建立,這一點特別重要。This is particularly important if the script requires a large amount of server resources to create.

IsClientScriptBlockRegistered 方法已被取代。The IsClientScriptBlockRegistered method has been deprecated. 在類別中使用IsClientScriptBlockRegistered方法 ClientScriptManagerUse the IsClientScriptBlockRegistered method in the ClientScriptManager class.

適用於

另請參閱