ClientScriptManager.IsClientScriptIncludeRegistered Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> boolPublic Function IsClientScriptIncludeRegistered (key As String) As BooleanParameter
- key
- String
Der Schlüssel des zu suchenden Clientskriptincludes.
Gibt zurück
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 -> boolPublic Function IsClientScriptIncludeRegistered (type As Type, key As String) As BooleanParameter
- type
- Type
Der Typ des zu suchenden Clientskriptincludes.
- key
- String
Der Schlüssel des zu suchenden Clientskriptincludes.
Gibt zurück
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.