Freigeben über


ClientScriptManager.IsClientScriptIncludeRegistered Methode

Definition

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

Überlädt

IsClientScriptIncludeRegistered(String)

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

IsClientScriptIncludeRegistered(Type, String)

Bestimmt unter Verwendung des Schlüssels und des Typs, ob der Clientskriptinclude für das Page-Objekt registriert ist.

IsClientScriptIncludeRegistered(String)

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

public:
 bool IsClientScriptIncludeRegistered(System::String ^ key);
public bool IsClientScriptIncludeRegistered (string key);
member this.IsClientScriptIncludeRegistered : string -> bool
Public Function IsClientScriptIncludeRegistered (key As String) As Boolean

Parameter

key
String

Der Schlüssel des zu suchenden Clientskriptincludes.

Gibt zurück

Boolean

true, wenn der Clientskriptinclude registriert ist, andernfalls false.

Hinweise

Rufen Sie diese Methode auf, bevor Sie die RegisterClientScriptInclude Methode aufrufen, um doppelte Skripts zu vermeiden. Dies ist besonders wichtig, wenn das Skript eine große Menge von Serverressourcen zum Erstellen benötigt.

Ein Clientskript ist eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Skripts mit demselben Schlüssel und Typ werden als Duplikate betrachtet.

Diese Überladung der IsStartupScriptRegistered Methode ruft die Überladung auf, die sowohl einen Parameter als auch einen key type Parameter mit dem Typ aufruft, der als Objekt festgelegt ist Page .

Siehe auch

Gilt für

IsClientScriptIncludeRegistered(Type, String)

Bestimmt unter Verwendung des Schlüssels und des Typs, ob der Clientskriptinclude für das Page-Objekt registriert ist.

public:
 bool IsClientScriptIncludeRegistered(Type ^ type, System::String ^ key);
public bool IsClientScriptIncludeRegistered (Type type, string key);
member this.IsClientScriptIncludeRegistered : Type * string -> bool
Public Function IsClientScriptIncludeRegistered (type As Type, key As String) As Boolean

Parameter

type
Type

Der Typ des zu suchenden Clientskriptincludes.

key
String

Der Schlüssel des zu suchenden Clientskriptincludes.

Gibt zurück

Boolean

true, wenn der Clientskriptinclude registriert ist, andernfalls false.

Ausnahmen

Der Typ des Clientskriptincludes ist null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsClientScriptIncludeRegistered Methode veranschaulicht. Beachten Sie, dass, wenn die Logik zum Überprüfen auf das vorhandene Clientskript entfernt wurde, nicht zwei duplizierte Clientskripts im HTML-Quellcode der gerenderten Seite vorhanden wären, da die RegisterClientScriptInclude Methode nach Duplikaten sucht. Der Vorteil der Überprüfung besteht darin, unnötige Berechnungen zu reduzieren.

<%@ 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, type and url of the client script on the page.
        String csname = "ButtonClickScript";
        String csurl = "~/script_include.js";
        Type cstype = this.GetType();

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

        // Check to see if the include script exists already.
        if (!cs.IsClientScriptIncludeRegistered(cstype, csname))
        {
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl));
        }

    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </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 System.EventArgs)

        ' Define the name, type and url of the client script on the page.
        Dim csname As String = "ButtonClickScript"
        Dim csurl As String = "~/script_include.js"
        Dim cstype As Type = Me.GetType()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript
    
        ' Check to see if the include script is already registered.
        If (Not cs.IsClientScriptIncludeRegistered(cstype, csname)) Then
      
            cs.RegisterClientScriptInclude(cstype, csname, ResolveClientUrl(csurl))
      
        End If
    
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
     <form id="Form1" runat="server">
     <div>
        <input type="text"
               id="Message"/> 
        <input type="button" 
               value="ClickMe"
               onclick="DoClick()"/>
     </div>
     </form>
</body>
</html>

In diesem Beispiel ist eine JavaScript-Datei mit dem Namen " Script_include.js, mit dem folgenden Inhalt erforderlich:

function DoClick() {Form1.Message.value='Text from include script.'}  

Hinweise

Rufen Sie diese Methode auf, bevor Sie die RegisterClientScriptInclude Methode aufrufen, um das Registrieren doppelter Clientskripts zu vermeiden. Dies ist besonders wichtig, wenn das Skript eine große Menge von Serverressourcen zum Erstellen benötigt.

Ein Clientskript ist eindeutig durch seinen Schlüssel und seinen Typ identifiziert. Skripts mit demselben Schlüssel und Typ werden als Duplikate betrachtet. Sie geben den Typ basierend auf dem Objekt an, das auf die Ressource zugreift. Wenn Sie beispielsweise eine Page-Instanz verwenden, um auf die Ressource zuzugreifen, geben Sie den Page Typ an.

Siehe auch

Gilt für