ClientScriptManager.IsStartupScriptRegistered Methode

Definition

Bestimmt, ob das Startskript für das Page-Objekt registriert ist.Determines whether the startup script is registered with the Page object.

Überlädt

IsStartupScriptRegistered(Type, String)

Bestimmt unter Verwendung des angegebenen Schlüssels und Typs, ob das Startskript für das Page-Objekt registriert ist.Determines whether the startup script is registered with the Page object using the specified key and type.

IsStartupScriptRegistered(String)

Bestimmt unter Verwendung des angegebenen Schlüssels, ob das Startskript für das Page-Objekt registriert ist.Determines whether the startup script is registered with the Page object using the specified key.

IsStartupScriptRegistered(Type, String)

Bestimmt unter Verwendung des angegebenen Schlüssels und Typs, ob das Startskript für das Page-Objekt registriert ist.Determines whether the startup script is registered with the Page object using the specified key and type.

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

Parameter

type
Type

Der Typ des zu suchenden Startskripts.The type of the startup script to search for.

key
String

Der Schlüssel des zu suchenden Startskripts.The key of the startup script to search for.

Gibt zurück

true, wenn das Startskript registriert ist, andernfalls false.true if the startup script is registered; otherwise, false.

Ausnahmen

Der Startskripttyp ist null.The startup script type is null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung IsStartupScriptRegistered der-Methode veranschaulicht.The following code example demonstrates the use of the IsStartupScriptRegistered method. Beachten Sie Folgendes: Wenn die Logik zum Überprüfen des vorhandenen Startskript Blocks entfernt wurde, sind im HTML-Quellcode der gerenderten Seite nicht zwei doppelte Start Skripts vorhanden, RegisterStartupScript da die-Methode auf Duplikate prüft.Note that, if the logic to check for the existing startup script block were removed, there would not be two duplicate startup scripts in the HTML source code of the rendered page because the RegisterStartupScript method checks for duplicates. Der Vorteil der Überprüfung besteht darin, unnötige Berechnungen zu verringern.The benefit of checking is to reduce unnecessary computation.

<%@ 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, RegisterStartupScript bevor Sie die-Methode aufrufen, damit doppelte Skripts nicht registriertCall this method before calling the RegisterStartupScript method to avoid registering duplicate scripts. 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.

Ein Client Startskript wird durch seinen Schlüssel und dessen Typ eindeutig identifiziert.A client startup script is uniquely identified by its key and its type. Skripts mit demselben Schlüssel und Typ werden als Duplikate angesehen.Scripts with the same key and type are considered duplicates.

Siehe auch

IsStartupScriptRegistered(String)

Bestimmt unter Verwendung des angegebenen Schlüssels, ob das Startskript für das Page-Objekt registriert ist.Determines whether the startup script is registered with the Page object using the specified key.

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.The key of the startup script to search for.

Gibt zurück

true, wenn das Startskript registriert ist, andernfalls false.true if the startup script is registered; otherwise, false.

Hinweise

Rufen Sie diese Methode auf, RegisterStartupScript bevor Sie die-Methode aufrufen, damit doppelte Skripts nicht registriertCall this method before calling the RegisterStartupScript method to avoid registering duplicate scripts. 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.

Ein Startskript wird durch seinen Schlüssel und dessen Typ eindeutig identifiziert.A startup script is uniquely identified by its key and its type. Skripts mit demselben Schlüssel und Typ werden als Duplikate angesehen.Scripts with the same key and type are considered duplicates.

Diese Überladung der IsStartupScriptRegistered -Methode ruft die-Überladung auf, key die sowohl type eine Zeichenfolge als auch einen Parameter Page mit dem Typ als-Objekt annimmt.This overload of the IsStartupScriptRegistered method calls the overload that takes both a string key and a type parameter with the type set as a Page object

Siehe auch

Gilt für: