ClientScriptManager.IsClientScriptIncludeRegistered Methode

Definition

Bestimmt, ob der Clientskriptinclude für das Page-Objekt registriert ist.Determines whether the client script include is registered with the Page object.

Überlädt

IsClientScriptIncludeRegistered(String)

Bestimmt unter Verwendung des angegebenen Schlüssels, ob der Clientskriptinclude für das Page-Objekt registriert ist.Determines whether the client script include is registered with the Page object using the specified key.

IsClientScriptIncludeRegistered(Type, String)

Bestimmt unter Verwendung des Schlüssels und des Typs, ob der Clientskriptinclude für das Page-Objekt registriert ist.Determines whether the client script include is registered with the Page object using a key and type.

IsClientScriptIncludeRegistered(String)

Bestimmt unter Verwendung des angegebenen Schlüssels, ob der Clientskriptinclude für das Page-Objekt registriert ist.Determines whether the client script include is registered with the Page object using the specified key.

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.The key of the client script include to search for.

Gibt zurück

true, wenn der Clientskriptinclude registriert ist, andernfalls false.true if the client script include is registered; otherwise, false.

Hinweise

Rufen Sie diese Methode auf, RegisterClientScriptInclude bevor Sie die-Methode aufrufen, damit doppelte Skripts nicht registriertCall this method before calling the RegisterClientScriptInclude method to avoid registering duplicate scripts. Dies ist besonders wichtig, wenn das Skript eine große Menge an Server Ressourcen benötigt, die erstellt werden müssen.This is particularly important if the script requires a large amount of server resources to create.

Ein Clientskriptinclude wird durch seinen Schlüssel und dessen Typ eindeutig identifiziert.A client script include is uniquely identified by its key and its type. Skripts mit demselben Schlüssel und Typ werden als Duplikate angesehen.Scripts with the same key and type are considered duplicates.

Diese Überladung der IsStartupScriptRegistered -Methode ruft die-Überladung auf key , die type einen-Parameter und einen-Parameter Page mit dem Typ als-Objekt annimmt.This overload of the IsStartupScriptRegistered method calls the overload that takes both a key and a type parameter with the type set as a Page object.

Siehe auch

IsClientScriptIncludeRegistered(Type, String)

Bestimmt unter Verwendung des Schlüssels und des Typs, ob der Clientskriptinclude für das Page-Objekt registriert ist.Determines whether the client script include is registered with the Page object using a key and type.

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

Parameter

type
Type

Der Typ des zu suchenden Clientskriptincludes.The type of the client script include to search for.

key
String

Der Schlüssel des zu suchenden Clientskriptincludes.The key of the client script include to search for.

Gibt zurück

true, wenn der Clientskriptinclude registriert ist, andernfalls false.true if the client script include is registered; otherwise, false.

Ausnahmen

Der Typ des Clientskriptincludes ist null.The client script include type is null.

Beispiele

Im folgenden Codebeispiel wird die Verwendung IsClientScriptIncludeRegistered der-Methode veranschaulicht.The following code example demonstrates the use of the IsClientScriptIncludeRegistered method. Beachten Sie Folgendes: Wenn die Logik zum Überprüfen auf das vorhandene Client Skript entfernt wurde, sind im HTML-Quellcode der gerenderten Seite nicht zwei doppelte Client Skripts vorhanden, RegisterClientScriptInclude da die-Methode auf Duplikate prüft.Note that, if the logic to check for the existing client script include were removed, there would not be two duplicate client scripts in the HTML source code of the rendered page because the RegisterClientScriptInclude method checks for duplicates. Der Vorteil der Überprüfung besteht darin, unnötige Berechnungen zu verringern.The benefit of checking is to reduce unnecessary computation.

<%@ 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>

Für dieses Beispiel ist eine JavaScript- Script_include.jsDatei mit dem Namen mit folgendem Inhalt erforderlich:This example requires a JavaScript file named Script_include.js, with the following contents:

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

Hinweise

Rufen Sie diese Methode auf, RegisterClientScriptInclude bevor Sie die-Methode aufrufen, um zu vermeiden, dass doppelte Client Skript-Call this method before calling the RegisterClientScriptInclude method to avoid registering duplicate client script includes. Dies ist besonders wichtig, wenn das Skript eine große Menge an Server Ressourcen benötigt, die erstellt werden müssen.This is particularly important if the script requires a large amount of server resources to create.

Ein Clientskriptinclude wird durch seinen Schlüssel und dessen Typ eindeutig identifiziert.A client script include is uniquely identified by its key and its type. Skripts mit demselben Schlüssel und Typ werden als Duplikate angesehen.Scripts with the same key and type are considered duplicates. Sie geben den Typ basierend auf dem Objekt an, das auf die Ressource zugreift.You specify the type based on the object that will be accessing the resource. Wenn Sie z. b. für den Zugriff auf die Ressource eine Seiten Instanz verwenden Page , geben Sie den Typ an.For instance, when using a Page instance to access the resource, you specify the Page type.

Siehe auch

Gilt für: