Condividi tramite

ScriptManager.RegisterStartupScript Metodo

Definizione

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

Registra un blocco di script di avvio con il ScriptManager controllo e aggiunge il blocco di script alla pagina.

Overload

Nome Descrizione
RegisterStartupScript(Control, Type, String, String, Boolean)

Registra un blocco di script di avvio per un controllo che si trova all'interno di un UpdatePanel oggetto utilizzando il ScriptManager controllo e aggiunge il blocco di script alla pagina.
RegisterStartupScript(Page, Type, String, String, Boolean)

Registra un blocco di script di avvio per ogni postback asincrono con il ScriptManager controllo e aggiunge il blocco di script alla pagina.

RegisterStartupScript(Control, Type, String, String, Boolean)

Registra un blocco di script di avvio per un controllo che si trova all'interno di un UpdatePanel oggetto utilizzando il ScriptManager controllo e aggiunge il blocco di script alla pagina.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript(System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parametri

control
Control

Controllo che registra il blocco di script client.

type
Type

Tipo del blocco di script client. Questo parametro viene in genere specificato usando l'operatore typeof (C#) o l'operatore GetType (Visual Basic) per recuperare il tipo del controllo che sta registrando lo script.

key
String

Identificatore univoco per il blocco di script.

script
String

Script da registrare.

addScriptTags
Boolean

true per racchiudere il blocco di script con <script> i tag e </script> ; in caso contrario, false.

Eccezioni

ArgumentNullException

control è null.

oppure

type è null.

ArgumentException

control non si trova nell'albero dei controlli della pagina.

Commenti

Si usa il RegisterStartupScript metodo per registrare un blocco di script di avvio per una pagina compatibile con il rendering di pagine parziali e senza dipendenze di Microsoft Ajax Library. I blocchi di script di avvio registrati tramite questo metodo vengono inviati alla pagina solo quando il controllo che registra il blocco si trova all'interno di un UpdatePanel controllo che viene aggiornato. Per registrare un blocco di script di avvio ogni volta che si verifica un postback asincrono, usare l'overload RegisterStartupScript(Page, Type, String, String, Boolean) di questo metodo.

Se si vuole registrare uno script di avvio che non riguarda gli aggiornamenti a pagina parziale e se si vuole registrare lo script una sola volta durante il rendering iniziale della pagina, usare il RegisterStartupScript metodo della ClientScriptManager classe . È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla ClientScript proprietà della pagina.

Il blocco di script sottoposto a rendering dal metodo viene eseguito al termine del RegisterStartupScript caricamento della pagina, ma prima che venga generato l'evento client onload della pagina. I blocchi di script di avvio si trovano nella parte inferiore della pagina di ASP.NET di rendering subito prima del </form> tag.

I blocchi di script di avvio registrati tramite non RegisterStartupScript sono garantiti per l'output nello stesso ordine in cui vengono registrati. Se l'ordine dei blocchi di script di avvio è importante, usare un StringBuilder oggetto per raccogliere i blocchi di script in una singola stringa e quindi registrarli tutti come uno script di avvio singolo.

Vedi anche

Si applica a

RegisterStartupScript(Page, Type, String, String, Boolean)

Registra un blocco di script di avvio per ogni postback asincrono con il ScriptManager controllo e aggiunge il blocco di script alla pagina.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);
public static void RegisterStartupScript(System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);
static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit
Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parametri

page
Page

Oggetto pagina che registra il blocco di script client.

type
Type

Tipo del blocco di script client. Questo parametro viene in genere specificato usando l'operatore typeof (C#) o l'operatore GetType (Visual Basic) per recuperare il tipo del controllo che sta registrando lo script.

key
String

Identificatore univoco per il blocco di script.

script
String

Script da registrare.

addScriptTags
Boolean

true per racchiudere il blocco di script con <script> i tag e </script> ; in caso contrario, false.

Commenti

Questo metodo viene usato per registrare un blocco di script di avvio incluso ogni volta che si verifica un postback asincrono. Per registrare un blocco di script per un controllo all'interno di un UpdatePanel controllo in modo che il blocco di script venga registrato solo quando il UpdatePanel controllo viene aggiornato, utilizzare l'overload RegisterStartupScript(Control, Type, String, String, Boolean) di questo metodo.

Se si vuole registrare uno script di avvio che non riguarda gli aggiornamenti a pagina parziale e se si vuole registrare lo script una sola volta durante il rendering iniziale della pagina, usare il RegisterStartupScript metodo della ClientScriptManager classe . È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla ClientScript proprietà della pagina.

Vedi anche

Si applica a