Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo ClientScriptManager.IsStartupScriptRegistered (Type, String)

 

Data di pubblicazione: ottobre 2016

Determina se lo script di avvio è registrato con il Page con la chiave specificata e il tipo dell'oggetto.

Spazio dei nomi:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public bool IsStartupScriptRegistered(
	Type type,
	string key
)

Parametri

type
Type: System.Type

Il tipo di script di avvio per la ricerca.

key
Type: System.String

La chiave dello script di avvio per la ricerca.

Valore restituito

Type: System.Boolean

true Se viene registrato lo script di avvio. in caso contrario, false.

Exception Condition
ArgumentNullException

Il tipo di script di avvio è null.

Chiamare questo metodo prima di chiamare il RegisterStartupScript metodo per evitare la registrazione di 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 rispettiva chiave e il relativo tipo. Gli script con la stessa chiave e tipo sono considerati duplicati.

Esempio di codice riportato di seguito viene illustrato l'utilizzo di IsStartupScriptRegistered metodo. Si noti che, se la logica per cercare il blocco di script di avvio esistenti sono stati rimossi, il codice sorgente HTML della pagina rendering non sarebbe script di avvio duplicato, poiché il RegisterStartupScript metodo controlla la presenza di duplicati. Il vantaggio di un controllo consiste nel ridurre calcolo non necessarie.

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

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: