ScriptManager.RegisterStartupScript Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Inscrit un bloc de script de démarrage auprès du ScriptManager contrôle et ajoute le bloc de script à la page.
Surcharges
| Nom | Description |
|---|---|
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Inscrit un bloc de script de démarrage pour un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle à l’aide du ScriptManager contrôle 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 asynchrone auprès du ScriptManager contrôle 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 qui se trouve à l’intérieur d’un UpdatePanel contrôle à l’aide du ScriptManager contrôle 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é à l’aide de l’opérateur typeof (C#) ou de 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
Script à inscrire.
- addScriptTags
- Boolean
true pour placer le bloc de script avec <script> et </script> les balises ; sinon, false.
Exceptions
control n’est pas dans l’arborescence de 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 partielle et qui n’a aucune dépendance de bibliothèque Microsoft Ajax. Les blocs de script de démarrage 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 partielles de page et si vous souhaitez inscrire le script une seule fois pendant le 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 affiché par la RegisterStartupScript méthode s’exécute lorsque la page termine le chargement, mais avant que l’événement client onload de la page soit déclenché. Les blocs de script de démarrage se trouvent en bas de la page de ASP.NET rendue juste avant la </form> balise.
Les blocs de script de démarrage inscrits à l’aide RegisterStartupScript ne sont pas garantis pour être générés dans le même ordre dans lequel ils sont inscrits. Si l’ordre des blocs de script de démarrage est important, utilisez un StringBuilder objet pour collecter les blocs de script dans une seule chaîne, puis inscrivez-les en tant que script de démarrage unique.
Voir aussi
S’applique à
RegisterStartupScript(Page, Type, String, String, Boolean)
Inscrit un bloc de script de démarrage pour chaque publication asynchrone auprès du ScriptManager contrôle 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 de 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é à l’aide de l’opérateur typeof (C#) ou de 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
Script à inscrire.
- addScriptTags
- Boolean
true pour placer le bloc de script avec <script> et </script> les balises ; sinon, false.
Remarques
Vous utilisez cette méthode pour inscrire un bloc de script de démarrage 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 partielles de page et si vous souhaitez inscrire le script une seule fois pendant le 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.