Page.RegisterStartupScript(String, String) Methode

Definition

Warnung

Diese API ist jetzt veraltet.

Emits a client-side script block in the page response.Emits a client-side script block in the page response.

public:
 virtual void RegisterStartupScript(System::String ^ key, System::String ^ script);
[System.Obsolete("The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). https://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
Public Overridable Sub RegisterStartupScript (key As String, script As String)

Parameter

key
String

Unique key that identifies a script block.Unique key that identifies a script block.

script
String

Content of script that will be sent to the client.Content of script that will be sent to the client.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der RegisterStartupScript-Methode in Verbindung mit der IsStartupScriptRegistered-Methode veranschaulicht.The following code example demonstrates the use of the RegisterStartupScript method in conjunction with the IsStartupScriptRegistered method. Wenn das im Code Deklarations Block geschriebene ECMAScript nicht bereits registriert wurde (wie durch die IsStartupScriptRegistered-Methode festgelegt), wird ein RegisterStartupScript aufgerufen.If the ECMAScript written in the code declaration block has not already been registered, as determined by the IsStartupScriptRegistered method, then a RegisterStartupScript call is made.

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

Hinweise

Ähnlich wie bei der RegisterClientScriptBlock-Methode gibt die RegisterStartupScript-Methode das Skript direkt vor dem schließenden Tag des <form runat= server> Elements des Page-Objekts aus.Similar to the RegisterClientScriptBlock method, the RegisterStartupScript method emits the script just before the closing tag of the Page object's <form runat= server> element. Schließen Sie die öffnenden und schließenden <script> Elemente um die Skriptblock Zeichenfolge ein, die im script-Parameter angegeben ist.Be sure to include opening and closing <script> elements around the script block string specified in the script parameter.

Da diese Methode einen Schlüssel zum Identifizieren des Skript Blocks verwendet, muss der Skriptblock nicht jedes Mal, wenn er von einer anderen Server Steuerungs Instanz angefordert wird, an den Ausgabestream ausgegeben werden.Because this method uses a key to identify the script block, the script block does not have to be emitted to the output stream each time it is requested by a different server control instance

Alle Skriptblöcke mit denselben key Parameterwerten werden als Duplikate angesehen.Any script blocks with the same key parameter values are considered duplicates.

Hinweis

Denken Sie daran, HTML-Kommentar Tags in das Skript einzufügen, sodass es nicht gerendert wird, wenn der anfordernde Browser keine Skripts unterstützt.Remember to include HTML comment tags around your script so that it will not be rendered if the requesting browser does not support scripts.

Die RegisterStartupScript-Methode ist veraltet.The RegisterStartupScript method has been deprecated. Verwenden Sie stattdessen die RegisterStartupScript-Methode in der ClientScriptManager-Klasse.Use the RegisterStartupScript method in the ClientScriptManager class instead.

Gilt für:

Siehe auch