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

Definition

Warnung

Diese API ist jetzt veraltet.

Bestimmt, ob der Clientskriptblock mit dem angegebenen Schlüssel für die Seite registriert ist.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

Parameter

key
String String String String

Der zu suchende Zeichenfolgenschlüssel für das Clientskript.The string key of the client script to search for.

Gibt zurück

true, wenn der Skriptblock registriert ist, andernfalls false.true if the script block is registered; otherwise, false.

Beispiele

Im folgenden Codebeispiel wird die Verwendung RegisterClientScriptBlock der-Methode in Verbindung mit der IsClientScriptBlockRegistered -Methode veranschaulicht.The following code example demonstrates the use of the RegisterClientScriptBlock method in conjunction with the IsClientScriptBlockRegistered method. Wenn das im Code Deklarations Block geschriebene ECMAScript nicht bereits registriert wurde (wie durch IsClientScriptBlockRegisteredfestgelegt), erfolgt ein RegisterClientScriptBlock -Rückruf.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>

Hinweise

Rufen Sie diese Methode auf Page.RegisterClientScriptBlock , bevor Sie aufrufen, um das Client seitige Skript unnötig zu vermeiden.Call this method before calling Page.RegisterClientScriptBlock to avoid unnecessarily assembling the client-side script. Dies ist besonders wichtig, wenn das Skript eine große Menge an Server Ressourcen benötigt, die erstellt werden müssen.This is particularly important if the script requires a large amount of server resources to create.

Die IsClientScriptBlockRegistered-Methode ist veraltet.The IsClientScriptBlockRegistered method has been deprecated. Verwenden Sie IsClientScriptBlockRegistered die-Methode ClientScriptManager in der-Klasse.Use the IsClientScriptBlockRegistered method in the ClientScriptManager class.

Gilt für:

Siehe auch