Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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

 

Date de publication : novembre 2016

Inscrit le script de démarrage avec le Page de l’objet à l’aide d’un type, une clé, un littéral de script et une valeur booléenne 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

Le type du script de démarrage à inscrire.

key
Type: System.String

Clé du script de démarrage à inscrire.

script
Type: System.String

Le littéral pour enregistrer le script de démarrage.

addScriptTags
Type: System.Boolean

Valeur booléenne indiquant s’il faut ajouter des balises de script.

Exception Condition
ArgumentNullException

type a la valeur null.

Un script de démarrage est identifié de manière unique par sa clé et son type. Scripts avec la même clé et le même type sont considérés comme des doublons. Qu’un seul script avec un type donné et une paire de clés peut être enregistré avec la page. Tentative d’inscription d’un script qui est déjà inscrite ne crée pas un doublon du script.

Appelez le IsStartupScriptRegistered méthode pour déterminer si un script de démarrage avec une paire clé / type donnée est déjà enregistré et éviter toute tentative d’ajout du script.

Dans cette surcharge de la RegisterStartupScript (méthode), vous pouvez indiquer si le script a fourni dans le script paramètre est encapsulé avec un <script> bloc d’élément à l’aide de le addScriptTags paramètre. Définition de addScriptTags à true indique que les balises de script sont ajoutés automatiquement.

Le bloc de script ajouté par la RegisterStartupScript méthode s’exécute lorsque la page chargée, mais avant de la page OnLoad événement est déclenché. Les blocs de script ne sont pas garanti que la sortie dans l’ordre, qu'ils sont inscrits. Si l’ordre des blocs de script est important, utilisez un StringBuilder de l’objet pour rassembler les scripts dans une chaîne unique, puis inscrivez-les tous dans un bloc de script client unique.

L’exemple de code suivant illustre l’utilisation de la RegisterStartupScript méthode. Notez que le addScriptTags paramètre a la valeur false pour le début et la fermeture des balises de script sont inclus dans le script paramètre.

<%@ 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
Disponible depuis 2.0
Retour au début
Afficher: