Freigeben über


Page.IsStartupScriptRegistered-Methode

HINWEIS: Diese Methode ist mittlerweile veraltet.

Bestimmt, ob das Clientstartskript für das Page-Objekt registriert ist.

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

Syntax

'Declaration
<ObsoleteAttribute("The recommended alternative is ClientScript.IsStartupScriptRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Function IsStartupScriptRegistered ( _
    key As String _
) As Boolean
'Usage
Dim instance As Page
Dim key As String
Dim returnValue As Boolean

returnValue = instance.IsStartupScriptRegistered(key)
[ObsoleteAttribute("The recommended alternative is ClientScript.IsStartupScriptRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202")] 
public bool IsStartupScriptRegistered (
    string key
)
[ObsoleteAttribute(L"The recommended alternative is ClientScript.IsStartupScriptRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202")] 
public:
bool IsStartupScriptRegistered (
    String^ key
)
/** @attribute ObsoleteAttribute("The recommended alternative is ClientScript.IsStartupScriptRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202") */ 
public boolean IsStartupScriptRegistered (
    String key
)
ObsoleteAttribute("The recommended alternative is ClientScript.IsStartupScriptRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202") 
public function IsStartupScriptRegistered (
    key : String
) : boolean

Parameter

  • key
    Der zu suchende Zeichenfolgenschlüssel für das Startskript.

Rückgabewert

true, wenn das Startskript registriert ist, andernfalls false.

Hinweise

Rufen Sie diese Methode vor dem Aufruf von Page.RegisterStartupScript auf, um unnötiges Assemblieren des Clientskripts zu vermeiden. Dies ist besonders wichtig, wenn für das Skript das Erstellen einer großen Menge von Serverressourcen erforderlich ist.

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

Beispiel

Im folgenden Codebeispiel wird die Verwendung der RegisterStartupScript-Methode in Verbindung mit der IsStartupScriptRegistered-Methode veranschaulicht. Wenn durch IsStartupScriptRegistered 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.

Versionsinformationen

.NET Framework

Unterstützt in: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0

Siehe auch

Referenz

Page-Klasse
Page-Member
System.Web.UI-Namespace
RegisterStartupScript