ScriptManager.RegisterStartupScript Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Inscrit un bloc de script de démarrage avec le contrôle ScriptManager et ajoute le bloc de script à la page.

Surcharges

RegisterStartupScript(Control, Type, String, String, Boolean)	Inscrit un bloc de script de démarrage pour un contrôle situé à l'intérieur d'un UpdatePanel en utilisant le contrôle ScriptManager, et ajoute le bloc de script à la page.
RegisterStartupScript(Page, Type, String, String, Boolean)	Inscrit un bloc de script de démarrage pour chaque publication (postback) asynchrone avec le contrôle ScriptManager et ajoute le bloc de script à la page.

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

Inscrit un bloc de script de démarrage pour un contrôle situé à l'intérieur d'un UpdatePanel en utilisant le contrôle ScriptManager, et ajoute le bloc de script à la page.

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)

Paramètres

control

Control

Contrôle qui inscrit le bloc de script client.

type

Type

Type du bloc de script client. Ce paramètre est généralement spécifié en utilisant l'opérateur typeof (C#) ou l'opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key

String

Identificateur unique pour le bloc de script.

script

String

Le script à inscrire.

addScriptTags

Boolean

true pour mettre le bloc de script entre des balises <script> et </script> ; sinon, false.

Exceptions

ArgumentNullException

control a la valeur null.

-ou-

type a la valeur null.

ArgumentException

control n'est pas dans l'arborescence du contrôle de la page.

Remarques

Vous utilisez la RegisterStartupScript méthode pour inscrire un bloc de script de démarrage pour une page compatible avec le rendu de page partiel et qui n’a pas de dépendances Microsoft bibliothèque Ajax. Les blocs de script de démarrage qui sont inscrits à l’aide de cette méthode sont envoyés à la page uniquement lorsque le contrôle qui inscrit le bloc se trouve à l’intérieur d’un UpdatePanel contrôle en cours de mise à jour. Pour inscrire un bloc de script de démarrage chaque fois qu’une publication asynchrone se produit, utilisez la RegisterStartupScript(Page, Type, String, String, Boolean) surcharge de cette méthode.

Si vous souhaitez inscrire un script de démarrage qui ne concerne pas les mises à jour de page partielles et si vous souhaitez inscrire le script une seule fois lors du rendu de page initial, utilisez la RegisterStartupScript méthode de la ClientScriptManager classe . Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

Le bloc de script rendu par la RegisterStartupScript méthode s’exécute lorsque le chargement de la page est terminé, mais avant que l’événement client onload de la page ne soit déclenché. Les blocs de script de démarrage se trouvent au bas de la page ASP.NET rendue juste avant la </form> balise.

Il n’est pas garanti que les blocs de script de démarrage inscrits à l’aide RegisterStartupScript de soient générés dans l’ordre dans lequel ils sont inscrits. Si l’ordre des blocs de script de démarrage est important, utilisez un StringBuilder objet pour rassembler les blocs de script dans une chaîne unique, puis inscrivez-les tous en tant que script de démarrage unique.

Voir aussi

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

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

Inscrit un bloc de script de démarrage pour chaque publication (postback) asynchrone avec le contrôle ScriptManager et ajoute le bloc de script à la page.

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)

Paramètres

page

Page

Objet page qui inscrit le bloc de script client.

type

Type

Type du bloc de script client. Ce paramètre est généralement spécifié en utilisant l'opérateur typeof (C#) ou l'opérateur GetType (Visual Basic) pour récupérer le type du contrôle qui inscrit le script.

key

String

Identificateur unique pour le bloc de script.

script

String

Le script à inscrire.

addScriptTags

Boolean

true pour mettre le bloc de script entre des balises <script> et </script> ; sinon, false.

Remarques

Vous utilisez cette méthode pour inscrire un bloc de script de démarrage qui est inclus chaque fois qu’une publication asynchrone se produit. Pour inscrire un bloc de script pour un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle afin que le bloc de script soit inscrit uniquement lorsque le UpdatePanel contrôle est mis à jour, utilisez la RegisterStartupScript(Control, Type, String, String, Boolean) surcharge de cette méthode.

Si vous souhaitez inscrire un script de démarrage qui ne concerne pas les mises à jour de page partielles et si vous souhaitez inscrire le script une seule fois lors du rendu de page initial, utilisez la RegisterStartupScript méthode de la ClientScriptManager classe . Vous pouvez obtenir une référence à l’objet ClientScriptManager à partir de la ClientScript propriété de la page.

Voir aussi

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