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

ClientScriptManager.RegisterStartupScript, méthode (Type, String, String, Boolean)

Inscrit le script de démarrage avec l'objet Page à l'aide d'un type, d'une clé, d'un littéral de script et d'une valeur Boolean indiquant s'il faut ajouter des balises de script.

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

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

Paramètres

type
Type : System.Type
Type du script de démarrage à inscrire.
key
Type : System.String
Clé du script de démarrage à inscrire.
script
Type : System.String
Littéral du script de démarrage à inscrire.
addScriptTags
Type : System.Boolean
Valeur Boolean qui indique s'il faut ajouter des balises de script.

ExceptionCondition
ArgumentNullException

type a la valeur null.

Un script de démarrage est identifié de manière unique par sa clé et son type. Les scripts ayant la même clé et le même type sont considérés comme des doublons. Un seul script affichant une paire type/clé donnée peut être inscrit avec la page. Une tentative d'inscription d'un script déjà inscrit ne crée aucun doublon du script.

Appelez la méthode IsStartupScriptRegistered pour déterminer si un script de démarrage affichant une paire clé/type donnée est déjà enregistré, et ainsi éviter toute tentative inutile d'ajout de ce script.

Dans cette surcharge de la méthode RegisterStartupScript, vous pouvez indiquer si le script a fourni dans le paramètre script est encapsulé avec un bloc d'élément <script> au moyen du paramètre addScriptTags. Affecter à addScriptTags la valeur true indique que les balises de script sont ajoutées automatiquement.

Le bloc de script ajouté par la méthode RegisterStartupScript exécute lorsque la page termine de charger mais avant que l'événement d'OnLoad de la page est déclenché. Il n'est pas garanti que les blocs de script sortent dans l'ordre dans lequel ils sont enregistrés. Si l'ordre des blocs de script est important, utilisez un objet StringBuilder pour rassembler les scripts dans une chaîne unique, puis inscrivez-les tous dans un même bloc de script client.

L'exemple de code suivant illustre l'utilisation de la méthode RegisterStartupScript. Remarquez que le paramètre addScriptTags a la valeur false ; aussi, l'ouverture et la fermeture des balises de script sont incluses avec le paramètre script.


<%@ Page Language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  public void Page_Load(Object sender, EventArgs e)
  {
    // Define the name and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();

    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>


.NET Framework

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

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