Page.RegisterClientScriptBlock(String, String) Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

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.

Attention

The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202

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

public:
 virtual void RegisterClientScriptBlock(System::String ^ key, System::String ^ script);

public virtual void RegisterClientScriptBlock (string key, string script);

[System.Obsolete("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);

abstract member RegisterClientScriptBlock : string * string -> unit
override this.RegisterClientScriptBlock : string * string -> unit

[<System.Obsolete("The recommended alternative is ClientScript.RegisterClientScriptBlock(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202")>]
abstract member RegisterClientScriptBlock : string * string -> unit
override this.RegisterClientScriptBlock : string * string -> unit

Public Overridable Sub RegisterClientScriptBlock (key As String, script As String)

Paramètres

key: String

Clé unique qui identifie un bloc de script.

script: String

Contenu du script envoyé au client.

Attributs: ObsoleteAttribute

Exemples

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

<%@ 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>

<%@ Page Language="VB"  %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        Dim csname1 As String = "PopupScript"

        Dim csname2 As String = "ButtonClickScript"
    
        If Not IsClientScriptBlockRegistered(csname1) Then
            Dim cstext1 As String = "<script type=""text/javascript"">" & _
                "alert('Hello World');</" & "script>"
            RegisterStartupScript(csname1, cstext1)
        End If
    
        If Not IsClientScriptBlockRegistered(csname2) Then
            Dim cstext2 As 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())
        End If
    End Sub
</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>

Remarques

Le script côté client est émis juste après la balise d’ouverture de l’élément de <form runat= server> l’objetPage. Veillez à inclure les éléments d’ouverture et de fermeture <script> autour de la chaîne de bloc de script 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 à être émis dans le flux de sortie chaque fois qu’il est demandé par une instance de contrôle de serveur différente. L’utilisation d’une clé réduit également la probabilité que les blocs de script des différents contrôles interfèrent entre eux.

Tous les blocs de script avec les mêmes key valeurs de paramètre sont considérés comme des doublons.

Notes

N’oubliez pas d’inclure des balises de commentaire HTML autour de votre script afin qu’elle ne soit pas affichée si le navigateur demandeur ne prend pas en charge les scripts.

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

S’applique à