Page.RegisterStartupScript(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.RegisterStartupScript(Type type, string key, string script). http://go.microsoft.com/fwlink/?linkid=14202

Émet un bloc de script côté client dans la réponse de page.

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

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

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

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

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

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

Paramètres

key: String

Clé unique qui identifie un bloc de script.

script: String

Contenu du script qui sera envoyé au client.

Attributs: ObsoleteAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la RegisterStartupScript méthode conjointement avec la IsStartupScriptRegistered méthode . Si l’ECMAScript écrit dans le bloc de déclaration de code n’a pas encore été inscrit, comme déterminé par la IsStartupScriptRegistered méthode, un RegisterStartupScript appel 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

Comme pour la RegisterClientScriptBlock méthode, la RegisterStartupScript méthode émet le script juste avant la balise fermante de l’élément de l’objet Page<form runat= server> . Veillez à inclure des é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 besoin d’être émis dans le flux de sortie chaque fois qu’il est demandé par une instance de contrôle serveur différente

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’il ne soit pas rendu si le navigateur demandeur ne prend pas en charge les scripts.

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

S’applique à

Voir aussi

RegisterClientScriptBlock(String, String)

Partager via