ClientScriptManager.IsStartupScriptRegistered 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 das Startskript beim Page Objekt registriert ist.

Überlädt

Name	Beschreibung
IsStartupScriptRegistered(Type, String)	Bestimmt, ob das Startskript mit dem Page angegebenen Schlüssel und Typ beim Objekt registriert ist.
IsStartupScriptRegistered(String)	Bestimmt, ob das Startskript mit dem Page angegebenen Schlüssel beim Objekt registriert ist.

IsStartupScriptRegistered(Type, String)

Bestimmt, ob das Startskript mit dem Page angegebenen Schlüssel und Typ beim 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 Startskripts, nach dem gesucht werden soll.

key: String

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

Gibt zurück

Boolean

truewenn 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 zum Überprüfen auf den vorhandenen Startskriptblock entfernt wurde, nicht 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 doppelte Skripts zu vermeiden. Dies ist besonders wichtig, wenn das Skript eine große Anzahl von Serverressourcen zum Erstellen benötigt.

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

Weitere Informationen

Gilt für:

IsStartupScriptRegistered(String)

Bestimmt, ob das Startskript mit dem Page angegebenen Schlüssel beim 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 Startskripts, nach dem gesucht werden soll.

Gibt zurück

Boolean

truewenn das Startskript registriert ist; andernfalls . false

Hinweise

Ein Startskript wird eindeutig durch seinen Schlüssel und seinen Typ 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 Typ verwendet, der als Objekt festgelegt ist.Page

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?