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

Crea blocchi di script del lato client nella risposta.

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)

Parametri

key: String

Chiave univoca che identifica un blocco di script.

script: String

Contenuto dello script che viene inviato al client.

Attributi: ObsoleteAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del RegisterClientScriptBlock metodo in combinazione con il IsClientScriptBlockRegistered metodo . Se ECMAScript nel blocco di dichiarazione di codice non è già stato registrato, come determinato da IsClientScriptBlockRegistered, viene eseguita la RegisterClientScriptBlock 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

Lo script sul lato client viene generato subito dopo il tag di apertura 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 del controllo server diversa. L'uso di una chiave riduce anche la probabilità di blocchi di script di controlli diversi che interferiscono tra loro.

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 RegisterClientScriptBlock è stato deprecato. Utilizzare in alternativa il metodo RegisterClientScriptBlock nella classe ClientScriptManager.

Si applica a