ClientScriptManager.IsClientScriptIncludeRegistered Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Bepaalt of het clientscript is geregistreerd bij het Page object.
Overloads
| Name | Description |
|---|---|
| IsClientScriptIncludeRegistered(String) |
Bepaalt of het clientscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel. |
| IsClientScriptIncludeRegistered(Type, String) |
Bepaalt of het clientscript is geregistreerd bij het Page object met behulp van een sleutel en type. |
IsClientScriptIncludeRegistered(String)
Bepaalt of het clientscript is geregistreerd bij het Page object met behulp van de opgegeven sleutel.
public:
bool IsClientScriptIncludeRegistered(System::String ^ key);public bool IsClientScriptIncludeRegistered(string key);member this.IsClientScriptIncludeRegistered : string -> boolPublic Function IsClientScriptIncludeRegistered (key As String) As BooleanParameters
- key
- String
De sleutel van het clientscript is om naar te zoeken.
Retouren
true als het clientscript is geregistreerd; anders, false.
Opmerkingen
Roep deze methode aan voordat u de RegisterClientScriptInclude methode aanroept om te voorkomen dat dubbele scripts worden geregistreerd. Dit is met name belangrijk als voor het script een grote hoeveelheid serverbronnen nodig is om te maken.
Een clientscript bevat een unieke identificatie door de sleutel en het bijbehorende type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten.
Deze overbelasting van de IsStartupScriptRegistered methode roept de overbelasting aan die zowel een als key een type parameter gebruikt met het type dat is ingesteld als een Page object.
Zie ook
Van toepassing op
IsClientScriptIncludeRegistered(Type, String)
Bepaalt of het clientscript is geregistreerd bij het Page object met behulp van een sleutel en type.
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 BooleanParameters
- type
- Type
Het type clientscript dat moet worden gezocht.
- key
- String
De sleutel van het clientscript is om naar te zoeken.
Retouren
true als het clientscript is geregistreerd; anders, false.
Uitzonderingen
Het type clientscript is null.
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van de IsClientScriptIncludeRegistered methode. Als de logica om te controleren op het bestaande clientscript is verwijderd, zijn er geen twee dubbele clientscripts in de HTML-broncode van de weergegeven pagina omdat de RegisterClientScriptInclude methode controleert op duplicaten. Het voordeel van het controleren is om onnodige berekeningen te verminderen.
<%@ 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>
Voor dit voorbeeld is een JavaScript-bestand met de naam Script_include.jsvereist, met de volgende inhoud:
function DoClick() {Form1.Message.value='Text from include script.'}
Opmerkingen
Roep deze methode aan voordat u de RegisterClientScriptInclude methode aanroept om te voorkomen dat dubbele clientscripts worden geregistreerd. Dit is met name belangrijk als voor het script een grote hoeveelheid serverbronnen nodig is om te maken.
Een clientscript bevat een unieke identificatie door de sleutel en het bijbehorende type. Scripts met dezelfde sleutel en hetzelfde type worden beschouwd als duplicaten. U geeft het type op op basis van het object dat toegang krijgt tot de resource. Wanneer u bijvoorbeeld een pagina-exemplaar gebruikt om toegang te krijgen tot de resource, geeft u het Page type op.
