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.RegisterStartupScript (Type, String, String)

 

Data di pubblicazione: ottobre 2016

Registra lo script di avvio con il Page dell'oggetto utilizzando un tipo, una chiave e un valore letterale di script.

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

public void RegisterStartupScript(
	Type type,
	string key,
	string script
)

Parametri

type
Type: System.Type

Il tipo di script di avvio da registrare.

key
Type: System.String

La chiave dello script di avvio per la registrazione.

script
Type: System.String

Valore letterale per registrare lo script di avvio.

Uno script client viene identificato in modo univoco dalla rispettiva chiave e il relativo tipo. Gli script con la stessa chiave e tipo sono considerati duplicati. Con la pagina, è possibile registrare un solo script con un determinato tipo e una coppia di chiavi. Il tentativo di registrare uno script che è già registrato non crea un duplicato dello script.

Chiamare il IsStartupScriptRegistered metodo per determinare se è già registrato uno script di avvio con una coppia chiave / tipo ed evitare inutilmente il tentativo di aggiungere lo script.

In questo overload di RegisterStartupScript (metodo), è necessario assicurarsi che lo script fornito nel script parametro viene eseguito il wrapping con un <script> blocco di elementi.

Il blocco di script aggiunto mediante il RegisterStartupScript metodo viene eseguito al termine del caricamento della pagina ma prima che la pagina OnLoad viene generato l'evento. I blocchi di script non sono necessariamente restituiti nell'ordine in che cui vengono registrati. Se l'ordine dei blocchi di script è importante, utilizzare un StringBuilder dell'oggetto per raccogliere gli script in un'unica stringa e quindi registrarli tutti in un blocco di script client singolo.

Esempio di codice riportato di seguito viene illustrato l'utilizzo di RegisterStartupScript metodo. Si noti che l'inizio e chiusura dello script sono inclusi all'interno di script parametro. Eseguire lo script tag aggiunti in base all'impostazione parametro aggiuntivo, vedere il RegisterStartupScript metodo.

<%@ 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";
    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))
    {
        StringBuilder cstext1 = new StringBuilder();
        cstext1.Append("<script type=text/javascript> alert('Hello World!') </");
        cstext1.Append("script>");

        cs.RegisterStartupScript(cstype, csname1, cstext1.ToString());
    }
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>RegisterStartupScript</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>

    </div>
    </form>
</body>
</html>

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