ClientScriptManager.IsStartupScriptRegistered Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Determina se lo script di avvio è registrato con l'oggetto Page.

Overload

IsStartupScriptRegistered(Type, String)

Determina se lo script di avvio è stato registrato con l'oggetto Page utilizzando la chiave e il tipo specificati.
IsStartupScriptRegistered(String)

Determina se lo script di avvio è stato registrato con l'oggetto Page utilizzando la chiave specificata.

IsStartupScriptRegistered(Type, String)

Determina se lo script di avvio è stato registrato con l'oggetto Page utilizzando la chiave e il tipo specificati.

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

Parametri

type
Type

Tipo di script di avvio da cercare.

key
String

Chiave dello script di avvio da cercare.

Restituisce

Boolean

true se lo script di avvio è stato registrato, altrimenti false.

Eccezioni

ArgumentNullException

Il tipo di script di avvio è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del IsStartupScriptRegistered metodo . Si noti che, se la logica per verificare la presenza del blocco di script di avvio esistente è stata rimossa, non sono presenti due script di avvio duplicati nel codice sorgente HTML della pagina sottoposta a rendering perché il RegisterStartupScript metodo verifica la presenza di duplicati. Il vantaggio del controllo consiste nel ridurre il calcolo non necessario.

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

Commenti

Chiamare questo metodo prima di chiamare il RegisterStartupScript metodo per evitare di registrare script duplicati. Ciò è particolarmente importante se lo script richiede una grande quantità di risorse server da creare.

Uno script di avvio client viene identificato in modo univoco dalla relativa chiave e dal relativo tipo. Gli script con la stessa chiave e tipo sono considerati duplicati.

Vedi anche

Si applica a

IsStartupScriptRegistered(String)

Determina se lo script di avvio è stato registrato con l'oggetto Page utilizzando la chiave specificata.

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

Parametri

key
String

Chiave dello script di avvio da cercare.

Restituisce

Boolean

true se lo script di avvio è stato registrato, altrimenti false.

Commenti

Chiamare questo metodo prima di chiamare il RegisterStartupScript metodo per evitare di registrare script duplicati. Ciò è particolarmente importante se lo script richiede una grande quantità di risorse server da creare.

Uno script di avvio viene identificato in modo univoco dalla relativa chiave e dal relativo tipo. Gli script con la stessa chiave e tipo sono considerati duplicati.

Questo overload del IsStartupScriptRegistered metodo chiama l'overload che accetta sia una stringa key che un type parametro con il tipo impostato come Page oggetto

Vedi anche

Si applica a