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 das Clientskript einschließen mit dem Page Objekt registriert ist.
Überlädt
| Name | Beschreibung |
|---|---|
| IsClientScriptIncludeRegistered(String) |
Bestimmt, ob das Clientskript einschließen mit dem angegebenen Schlüssel mit dem Page Objekt registriert ist. |
| IsClientScriptIncludeRegistered(Type, String) |
Bestimmt, ob das Clientskript einschließen mit einem Schlüssel und Typ mit dem Page Objekt registriert ist. |
IsClientScriptIncludeRegistered(String)
Bestimmt, ob das Clientskript einschließen mit dem angegebenen Schlüssel mit dem 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 Clientskripts umfasst die Suche.
Gibt zurück
truewenn das Clientskript enthalten ist, wird registriert; 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 Anzahl von Serverressourcen zum Erstellen benötigt.
Ein Clientskript wird 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 key Parameter als auch einen type Parameter mit dem Typ verwendet, der als Page Objekt festgelegt ist.
Weitere Informationen
Gilt für:
IsClientScriptIncludeRegistered(Type, String)
Bestimmt, ob das Clientskript einschließen mit einem Schlüssel und Typ mit dem 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 Clientskripts, nach dem gesucht werden soll.
- key
- String
Der Schlüssel des Clientskripts umfasst die Suche.
Gibt zurück
truewenn das Clientskript enthalten ist, wird registriert; andernfalls . false
Ausnahmen
Der Typ des Clientskripts 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 doppelte Clientskripts im HTML-Quellcode der gerenderten Seite vorhanden wären, da die RegisterClientScriptInclude Methode auf Duplikate überprüft. 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 Anzahl von Serverressourcen zum Erstellen benötigt.
Ein Clientskript wird 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 für den Zugriff auf die Ressource verwenden, geben Sie den Page Typ an.
