Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ScriptManager.RegisterStartupScript, méthode (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.

Espace de noms :  System.Web.UI
Assembly :  System.Web.Extensions (dans System.Web.Extensions.dll)

public static void RegisterStartupScript(
	Control control,
	Type type,
	string key,
	string script,
	bool addScriptTags
)

Paramètres

control
Type : System.Web.UI.Control
Contrôle qui inscrit le bloc de script client.
type
Type : System.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
Type : System.String
Identificateur unique pour le bloc de script.
script
Type : System.String
Le script à inscrire.
addScriptTags
Type : System.Boolean
true pour mettre le bloc de script entre des balises <script> et </script> ; sinon, false.

ExceptionCondition
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.

Vous utilisez la méthode RegisterStartupScript pour inscrire un bloc de script de démarrage pour une page compatible avec le rendu de page partiel et n'ayant aucune dépendance Microsoft Ajax Library. 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 dans un contrôle UpdatePanel mis à jour. Pour inscrire un bloc de script de démarrage à chaque publication (postback) asynchrone, utilisez la surcharge RegisterStartupScript(Page, Type, String, String, Boolean) de cette méthode.

Si vous souhaitez inscrire un script de démarrage sans rapport avec des mises à jour de pages partielles, et si vous souhaitez inscrire le script une seule fois pendant le rendu de page initial, utilisez la méthode RegisterStartupScript de la classe ClientScriptManager. Vous pouvez obtenir une référence à l'objet ClientScriptManager issu de la propriété ClientScript de la page.

Le bloc de script restitué par la méthode RegisterStartupScript s'exécute une fois la page chargée, mais avant le déclenchement de l'événement onload client qu'elle contient. Les blocs de script de démarrage se trouvent en bas de la page ASP.NET rendue, juste avant la balise </form>.

Il n'est pas garanti que les blocs de script de démarrage inscrits à l'aide de RegisterStartupScript sortent dans le même ordre que celui dans lequel ils sont inscrits. Si l'ordre des blocs de script de démarrage est important, utilisez un objet StringBuilder pour rassembler les blocs de script dans une chaîne unique, puis inscrivez-les tous sous un même script de démarrage.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft