Freigeben über

Page.IsClientScriptBlockRegistered-Methode

  • Artikel

HINWEIS: Diese Methode ist mittlerweile veraltet.

Bestimmt, ob der Clientskriptblock mit dem angegebenen Schlüssel für die Seite registriert ist.

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

Syntax

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

returnValue = instance.IsClientScriptBlockRegistered(key)

[ObsoleteAttribute("The recommended alternative is ClientScript.IsClientScriptBlockRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202")] 
public bool IsClientScriptBlockRegistered (
    string key
)

[ObsoleteAttribute(L"The recommended alternative is ClientScript.IsClientScriptBlockRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202")] 
public:
bool IsClientScriptBlockRegistered (
    String^ key
)

/** @attribute ObsoleteAttribute("The recommended alternative is ClientScript.IsClientScriptBlockRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202") */ 
public boolean IsClientScriptBlockRegistered (
    String key
)

ObsoleteAttribute("The recommended alternative is ClientScript.IsClientScriptBlockRegistered(string key). https://go.microsoft.com/fwlink/?linkid=14202") 
public function IsClientScriptBlockRegistered (
    key : String
) : boolean

Parameter

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

Rückgabewert

true, wenn der Skriptblock registriert ist, andernfalls false.

Hinweise

Rufen Sie diese Methode vor dem Aufruf von Page.RegisterClientScriptBlock 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 IsClientScriptBlockRegistered-Methode ist veraltet. Verwenden Sie die IsClientScriptBlockRegistered-Methode in der ClientScriptManager-Klasse.

Beispiel

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

<html>
  <head>
     <script language="VB" runat="server">
       
       Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
         If (Not IsClientScriptBlockRegistered("clientScript")) Then
           
           'Form the script that is to be registered at client side.
           Dim scriptString As String = "<script language=JavaScript> function DoClick() {"
           scriptString += "myForm.show.value='Welcome to Microsoft .NET'}<"
           scriptString += "/"
           scriptString += "script>"
           RegisterClientScriptBlock("clientScript", scriptString)
         End If
         
       End Sub
     </script>
  </head>
  <body topmargin="20" leftmargin="10">
     <form id="myForm" runat="server">
        <input type="text" id="show" style="width=200">
      <input type="button" value="ClickMe" onclick="DoClick()">
     </form>
  </body>
</html>

<html>
  <head>
    <script language="C#" runat="server">

      public void Page_Load(Object sender, EventArgs e)
      {

        if (!this.IsClientScriptBlockRegistered("clientScript"))
        {
          // Form the script that is to be registered at client side.
          String scriptString = "<script language=JavaScript> function DoClick() {";
          scriptString += "myForm.show.value='Welcome to Microsoft .NET'}<";
          scriptString += "/";
          scriptString += "script>";
          this.RegisterClientScriptBlock("clientScript", scriptString);
        }
      }

     </script>
  </head>
  <body topmargin="20" leftmargin="10">
     <form id="myForm" runat="server">
        <input type="text" id="show" style="width=200"> <input type="button" value="ClickMe" onclick="DoClick()">
     </form>
  </body>
</html>

<html>
    <head>
        <script language="VJ#" runat="server">

          public void Page_Load(Object sender, EventArgs e)
          {
            if (!(this.IsClientScriptBlockRegistered("clientScript"))) 
            {
              // Form the script that is to be registered at client side.
              String scriptString = 
                "<script language=JavaScript> function DoClick() {";
              scriptString += "myForm.show.value='Welcome to Microsoft .NET'}<";
              scriptString += "/";
              scriptString += "script>";
              this.RegisterClientScriptBlock("clientScript", scriptString);
            }
        }//Page_Load
        </script>
    </head>
  <body topmargin="20" leftmargin="10">
     <form id="myForm" runat="server">
        <input type="text" id="show" style="width=200"> <input type="button" value="ClickMe" onclick="DoClick()">
     </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
RegisterClientScriptBlock