(0) exportieren Drucken
Alle erweitern

ClientScriptManager.IsClientScriptBlockRegistered-Methode (String)

Aktualisiert: November 2007

Bestimmt unter Verwendung des angegebenen Schlüssels, ob der Clientskriptblock für das Page-Objekt registriert ist.

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

public bool IsClientScriptBlockRegistered(
	string key
)
public boolean IsClientScriptBlockRegistered(
	String key
)
public function IsClientScriptBlockRegistered(
	key : String
) : boolean

Parameter

key
Typ: System.String
Der Schlüssel des zu suchenden Clientskriptblocks.

Rückgabewert

Typ: System.Boolean
true, wenn der Clientskriptblock registriert ist, andernfalls false.

Rufen Sie diese Methode vor dem Aufrufen der RegisterClientScriptBlock-Methode auf, um die Registrierung doppelter Skripts zu vermeiden. Dies ist besonders wichtig, wenn für das Skript das Erstellen einer großen Menge von Serverressourcen erforderlich ist.

Ein Clientskript wird eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Skripts mit gleichem Schlüssel und Typ gelten als Duplikate.

Diese Überladung der IsClientScriptBlockRegistered-Methode ruft die Überladung auf, die sowohl einen key-Parameter als auch einen type-Parameter annimmt, wobei der Typ als Page-Objekt festgelegt wird.

<%@ 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)
  {
    // Define the name and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();

    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, 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>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString());
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>


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

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft