ClientScriptManager.IsStartupScriptRegistered Methode

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Bestimmt, ob das Startskript für das Page-Objekt registriert ist.

Überlädt

IsStartupScriptRegistered(Type, String)

Bestimmt unter Verwendung des angegebenen Schlüssels und Typs, ob das Startskript für das Page-Objekt registriert ist.
IsStartupScriptRegistered(String)

Bestimmt unter Verwendung des angegebenen Schlüssels, ob das Startskript für das Page-Objekt registriert ist.

IsStartupScriptRegistered(Type, String)

Bestimmt unter Verwendung des angegebenen Schlüssels und Typs, ob das Startskript für das Page-Objekt registriert ist.

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

Parameter

type
Type

Der Typ des zu suchenden Startskripts.

key
String

Der Schlüssel des zu suchenden Startskripts.

Gibt zurück

Boolean

true, wenn das Startskript registriert ist, andernfalls false.

Ausnahmen

ArgumentNullException

Der Startskripttyp ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsStartupScriptRegistered -Methode veranschaulicht. Beachten Sie, dass, wenn die Logik zur Überprüfung auf den vorhandenen Startskriptblock entfernt würde, zwei doppelte Startskripts im HTML-Quellcode der gerenderten Seite vorhanden wären, da die RegisterStartupScript 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

Rufen Sie diese Methode auf, bevor Sie die RegisterStartupScript -Methode aufrufen, um zu vermeiden, dass doppelte Skripts registriert werden. Dies ist besonders wichtig, wenn für das Erstellen des Skripts eine große Menge an Serverressourcen erforderlich ist.

Ein Clientstartskript wird anhand seines Schlüssels und seines Typs eindeutig identifiziert. Skripts mit demselben Schlüssel und Typ werden als Duplikate betrachtet.

Weitere Informationen

Gilt für:

IsStartupScriptRegistered(String)

Bestimmt unter Verwendung des angegebenen Schlüssels, ob das Startskript für das Page-Objekt registriert ist.

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

Parameter

key
String

Der Schlüssel des zu suchenden Startskripts.

Gibt zurück

Boolean

true, wenn das Startskript registriert ist, andernfalls false.

Hinweise

Rufen Sie diese Methode auf, bevor Sie die RegisterStartupScript -Methode aufrufen, um zu vermeiden, dass doppelte Skripts registriert werden. Dies ist besonders wichtig, wenn für das Erstellen des Skripts eine große Menge an Serverressourcen erforderlich ist.

Ein Startskript wird anhand seines Schlüssels und seines Typs eindeutig identifiziert. Skripts mit demselben Schlüssel und Typ werden als Duplikate betrachtet.

Diese Überladung der IsStartupScriptRegistered -Methode ruft die -Überladung auf, die sowohl eine Zeichenfolge key als auch einen type Parameter mit dem als Page -Objekt festgelegten Typ akzeptiert.

Weitere Informationen

Gilt für: