Page.RegisterStartupScript(String, String) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Attenzione

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

Crea un blocco di script del lato client nella risposta della pagina.

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)

Parametri

key: String

Chiave univoca che identifica un blocco di script.

script: String

Contenuto dello script che verrà inviato al client.

Attributi: ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del RegisterStartupScript metodo in combinazione con il IsStartupScriptRegistered metodo . Se l'ECMAScript scritto nel blocco di dichiarazione di codice non è già stato registrato, come determinato dal IsStartupScriptRegistered metodo , viene effettuata una RegisterStartupScript chiamata.

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

Commenti

Analogamente al RegisterClientScriptBlock metodo , il RegisterStartupScript metodo genera lo script subito prima del tag di chiusura dell'elemento Page dell'oggetto <form runat= server> . Assicurarsi di includere gli elementi di apertura e chiusura <script> intorno alla stringa del blocco di script specificata nel script parametro .

Poiché questo metodo usa una chiave per identificare il blocco di script, il blocco di script non deve essere generato nel flusso di output ogni volta che viene richiesto da un'istanza diversa del controllo server

Tutti i blocchi di script con gli stessi key valori di parametro vengono considerati duplicati.

Nota

Ricordarsi di includere tag di commento HTML intorno allo script in modo che non venga eseguito il rendering se il browser richiedente non supporta gli script.

Il metodo RegisterStartupScript è stato deprecato. Utilizzare in alternativa il metodo RegisterStartupScript nella classe ClientScriptManager.

Si applica a

Vedi anche

RegisterClientScriptBlock(String, String)