Page.RegisterStartupScript-Methode

Artikel
08/20/2007

HINWEIS: Diese Methode ist mittlerweile veraltet.

Gibt in der Seitenantwort einen clientseitigen Skriptblock aus.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ObsoleteAttribute("The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Overridable Sub RegisterStartupScript ( _
    key As String, _
    script As String _
)
'Usage
Dim instance As Page
Dim key As String
Dim script As String

instance.RegisterStartupScript(key, script)

[ObsoleteAttribute("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
)

[ObsoleteAttribute(L"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
)

/** @attribute ObsoleteAttribute("The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202") */ 
public void RegisterStartupScript (
    String key, 
    String script
)

ObsoleteAttribute("The recommended alternative is ClientScript.RegisterStartupScript(Type type, string key, string script). https://go.microsoft.com/fwlink/?linkid=14202") 
public function RegisterStartupScript (
    key : String, 
    script : String
)

Parameter

key
Eindeutiger Schlüssel, der einen Skriptblock bezeichnet.

script
Inhalt des Skripts, das an den Client gesendet wird.

Hinweise

Ähnlich wie bei der RegisterClientScriptBlock-Methode gibt die RegisterStartupScript-Methode das Skript direkt vor dem Endtag des <form runat= server>-Elements für das Page-Objekt aus. Sie müssen den im script-Parameter angegebenen Skriptblock in öffnende und schließende <script>-Elemente einschließen.

Da diese Methode einen Schlüssel zum Identifizieren des Skriptblocks verwendet, muss der Skriptblock nicht bei jeder Anforderung durch eine andere Serversteuerelementinstanz an den Ausgabestream ausgegeben werden.

Alle Skriptblöcke mit denselben key-Parameterwerten werden als Duplikate betrachtet.

Hinweis

Vergessen Sie nicht, das Skript in HTML-Kommentartags einzuschließen, damit es nicht gerendert wird, wenn ein anfordernder Browser Skripts nicht unterstützt.

Die RegisterStartupScript-Methode ist veraltet. Verwenden Sie stattdessen die RegisterStartupScript-Methode in der ClientScriptManager-Klasse.

Beispiel

Im folgenden Codebeispiel wird die Verwendung der RegisterStartupScript-Methode in Verbindung mit der IsStartupScriptRegistered-Methode veranschaulicht. Wenn durch die IsStartupScriptRegistered-Methode bestimmt wurde, dass das im Codedeklarationsblock geschriebene ECMAScript noch nicht registriert ist, wird RegisterStartupScript aufgerufen.

<html>
  <head>
     <script language="VB" runat="server">
       Public Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
         If (Not Me.IsStartupScriptRegistered("Startup")) Then
           ' Form the script to be registered at client side.
           Dim scriptString As String = "<script language=JavaScript> function DoClick() {"
           scriptString += "showMessage2.innerHTML='<h4>Welcome to Microsoft .NET!</h4>'}"
           scriptString += "function Page_Load(){ showMessage1.innerHTML="
           scriptString += "'<h4>RegisterStartupScript Example</h4>'}<"
           scriptString += "/"
           scriptString += "script>"
           Me.RegisterStartupScript("Startup", scriptString)
         End If
       End Sub
        </script>
  </head>
  <body topmargin="20" leftmargin="10" onload="Page_Load()">
     <form id="myForm" runat="server">
        <span id="showMessage1"></span>
        <br>
        <input type="button" value="ClickMe" onclick="DoClick()">
        <br>
        <span id="showMessage2"></span>
     </form>
  </body>
</html>

<html>
  <head>
    <script language="C#" runat="server">
      public void Page_Load(Object sender, EventArgs e)
      {

        if (!this.IsStartupScriptRegistered("Startup"))
        {
          // Form the script to be registered at client side.
          String scriptString = "<script language=JavaScript> function DoClick() {";
          scriptString += "showMessage2.innerHTML='<h4>Welcome to Microsoft .NET!</h4>'}";
          scriptString += "function Page_Load(){ showMessage1.innerHTML=";
          scriptString += "'<h4>RegisterStartupScript Example</h4>'}<";
          scriptString += "/";
          scriptString += "script>";
          this.RegisterStartupScript("Startup", scriptString);
        }
      }
     </script>
  </head>
  <body topmargin="20" leftmargin="10" onload="Page_Load()">
     <form id="myForm" runat="server">
        <span id="showMessage1"></span>
        <br>
        <input type="button" value="ClickMe" onclick="DoClick()">
        <br>
        <span id="showMessage2"></span>
     </form>
  </body>
</html>

<html>
    <head>
        <script language="VJ#" runat="server">
          public void Page_Load(Object sender, EventArgs e)
          {

            if (!(this.IsStartupScriptRegistered("Startup")))
            {
              // Form the script to be registered at client side.
              String scriptString = "<script language=JavaScript> function DoClick() {";
              scriptString += "showMessage2.innerHTML='<h4>Welcome" 
                + " to Microsoft .NET!</h4>'}";
              scriptString += "function Page_Load(){ showMessage1.innerHTML=";
              scriptString += "'<h4>RegisterStartupScript Example</h4>'}<";
              scriptString += "/";
              scriptString += "script>";
              this.RegisterStartupScript("Startup", scriptString);
            }
          } 
        </script>
    </head>
    <body topmargin="20" leftmargin="10" onload="Page_Load()">
        <form id="myForm" runat="server">
            <span id="showMessage1"></span>
            <br>
            <input type="button" value="ClickMe" onclick="DoClick()">
            <br>
            <span id="showMessage2"></span>
        </form>
    </body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Freigeben über

Page.RegisterStartupScript-Methode

Syntax

Parameter

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Zusätzliche Ressourcen