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

Page.RegisterClientScriptBlock méthode (String, String)

 

Date de publication : novembre 2016

Remarque : Cette API est désormais obsolète.

Émet des blocs de script côté client à la réponse.

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

[ObsoleteAttribute("The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202")]
public virtual void RegisterClientScriptBlock(
	string key,
	string script
)

Paramètres

key
Type: System.String

Clé unique qui identifie un bloc de script.

script
Type: System.String

Contenu du script envoyé au client.

Le script côté client est émis immédiatement après la balise d’ouverture de le Page l’objet <form runat= server> élément. Veillez à inclure l’ouverture et fermeture <script> autour du script bloque la chaîne spécifiée dans le script paramètre.

Étant donné que cette méthode utilise une clé pour identifier le bloc de script, le bloc de script n’a pas d’être émis vers le flux de sortie chaque fois qu’il est demandé par une instance de contrôle de serveur différent. À l’aide d’une clé réduit également la probabilité d’interférences des blocs de script des contrôles différents.

Les blocs de script ayant le même key des valeurs de paramètre sont considérés comme des doublons.

System_CAPS_noteRemarque

N’oubliez pas d’inclure des balises de commentaire HTML autour de votre script afin qu’il ne sera pas rendu si le navigateur qui ne prend pas en charge les scripts.

La méthode RegisterClientScriptBlock est déconseillée. Utilisez la RegisterClientScriptBlock méthode dans la ClientScriptManager classe à la place.

L’exemple de code suivant illustre l’utilisation de la RegisterClientScriptBlock méthode conjointement avec la IsClientScriptBlockRegistered méthode. Si le code ECMAScript du bloc de déclaration de code n’a pas déjà été inscrit, comme déterminé par IsClientScriptBlockRegistered, le RegisterClientScriptBlock est appelé.

<%@ 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)
  {
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";

    if (!IsClientScriptBlockRegistered(csname1))
    {
        String cstext1 = "<script type=\"text/javascript\">" +
            "alert('Hello World');</" + "script>";
        RegisterStartupScript(csname1, cstext1);
    }

    if (!IsClientScriptBlockRegistered(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>");
      RegisterClientScriptBlock(csname2, cstext2.ToString());
    }
  }
</script>
<html  >
  <head>
    <title>RegisterClientScriptBlock 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 1.1
Retour au début
Afficher: