ClientScriptManager.IsClientScriptBlockRegistered Methode

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bestimmt, ob der Clientskriptblock beim Page Objekt registriert ist.

Überlädt

Name	Beschreibung
IsClientScriptBlockRegistered(String)	Bestimmt, ob der Clientskriptblock mit dem angegebenen Schlüssel mit dem Page Objekt registriert wird.
IsClientScriptBlockRegistered(Type, String)	Bestimmt, ob der Clientskriptblock mit einem Schlüssel und Typ mit dem Page Objekt registriert ist.

IsClientScriptBlockRegistered(String)

Bestimmt, ob der Clientskriptblock mit dem angegebenen Schlüssel mit dem Page Objekt registriert wird.

public:
 bool IsClientScriptBlockRegistered(System::String ^ key);

public bool IsClientScriptBlockRegistered(string key);

member this.IsClientScriptBlockRegistered : string -> bool

Public Function IsClientScriptBlockRegistered (key As String) As Boolean

Parameter

key: String

Der Schlüssel des Clientskriptblocks, nach dem gesucht werden soll.

Gibt zurück

Boolean

truewenn der Clientskriptblock registriert ist; andernfalls . false

Beispiele

<%@ 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);
    }

    // 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());
    }
  }
</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)
      
    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())
      
    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>

Hinweise

Rufen Sie diese Methode auf, bevor Sie die RegisterClientScriptBlock Methode aufrufen, um doppelte Skripts zu vermeiden. Dies ist besonders wichtig, wenn das Skript eine große Anzahl von Serverressourcen zum Erstellen benötigt.

Ein Clientskript wird eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Skripts mit demselben Schlüssel und Typ werden als Duplikate betrachtet.

Diese Überladung der IsClientScriptBlockRegistered Methode ruft die Überladung auf, die sowohl einen key Parameter als auch einen type Parameter mit dem Typ verwendet, der als Objekt festgelegt ist.Page

Weitere Informationen

Gilt für:

IsClientScriptBlockRegistered(Type, String)

Bestimmt, ob der Clientskriptblock mit einem Schlüssel und Typ mit dem Page Objekt registriert ist.

public:
 bool IsClientScriptBlockRegistered(Type ^ type, System::String ^ key);

public bool IsClientScriptBlockRegistered(Type type, string key);

member this.IsClientScriptBlockRegistered : Type * string -> bool

Public Function IsClientScriptBlockRegistered (type As Type, key As String) As Boolean

Parameter

type: Type

Der Typ des clientskriptblocks, nach dem gesucht werden soll.

key: String

Der Schlüssel des Clientskriptblocks, nach dem gesucht werden soll.

Gibt zurück

Boolean

truewenn der Clientskriptblock registriert ist; andernfalls . false

Ausnahmen

ArgumentNullException

Der Clientskripttyp ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsClientScriptBlockRegistered Methode veranschaulicht. Beachten Sie, dass, wenn die Logik zum Überprüfen auf den vorhandenen Clientskriptblock entfernt wurde, keine zwei doppelten Clientskripts im HTML-Quellcode der gerenderten Seite vorhanden wären, da die RegisterClientScriptBlock Methode auf Duplikate überprüft. Der Vorteil der Überprüfung besteht darin, unnötige Berechnungen zu reduzieren.

<%@ 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>

Hinweise

Ein Clientskript wird eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Skripts mit demselben Schlüssel und Typ werden als Duplikate betrachtet. Sie geben den Typ basierend auf dem Objekt an, das auf die Ressource zugreift. Wenn Sie beispielsweise eine Page Instanz für den Zugriff auf die Ressource verwenden, geben Sie den Page Typ an.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?