Condividi tramite


ScriptManager.RegisterStartupScript Metodo

Definizione

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

Overload

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

Registra un blocco di script di avvio per un controllo compreso in un controllo UpdatePanel usando il controllo ScriptManager 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 controllo ScriptManager e aggiunge il blocco di script alla pagina.

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

Registra un blocco di script di avvio per un controllo compreso in un controllo UpdatePanel usando il controllo ScriptManager 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 includere il blocco di script nei tag <script> e </script>; in caso contrario, false.

Eccezioni

control è null.

-oppure- type è null.

control non si trova nella struttura ad albero dei controllo della pagina.

Commenti

Usare il RegisterStartupScript metodo per registrare un blocco di script di avvio per una pagina compatibile con il rendering a pagina parziale e che non ha dipendenze della libreria Microsoft Ajax. 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 della pagina iniziale, usare il RegisterStartupScript metodo della ClientScriptManager classe . È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla proprietà ClientScript della pagina.

Il blocco di script di cui viene eseguito il RegisterStartupScript rendering dal metodo viene eseguito al termine del 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 cui è stato eseguito il rendering subito prima del </form> tag.

Non è garantito che gli script di avvio registrati tramite tramite RegisterStartupScript vengano restituiti nello stesso ordine in cui sono 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 controllo ScriptManager 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 includere il blocco di script nei tag <script> 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 che si trova in un controllo UpdatePanel in modo che il blocco di script venga registrato solo quando il controllo UpdatePanel viene aggiornato, usare 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 della pagina iniziale, usare il RegisterStartupScript metodo della ClientScriptManager classe . È possibile ottenere un riferimento all'oggetto ClientScriptManager dalla proprietà ClientScript della pagina.

Vedi anche

Si applica a