ClientScriptManager.IsClientScriptIncludeRegistered Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Determina si el script de cliente incluye está registrado con el Page objeto .
Sobrecargas
| Nombre | Description |
|---|---|
| IsClientScriptIncludeRegistered(String) |
Determina si el script de cliente include está registrado con el Page objeto mediante la clave especificada. |
| IsClientScriptIncludeRegistered(Type, String) |
Determina si el script de cliente incluye está registrado con el Page objeto mediante una clave y un tipo. |
IsClientScriptIncludeRegistered(String)
Determina si el script de cliente include está registrado con el Page objeto mediante la clave especificada.
public:
bool IsClientScriptIncludeRegistered(System::String ^ key);public bool IsClientScriptIncludeRegistered(string key);member this.IsClientScriptIncludeRegistered : string -> boolPublic Function IsClientScriptIncludeRegistered (key As String) As BooleanParámetros
- key
- String
La clave del script de cliente incluye para buscar.
Devoluciones
true si el script de cliente incluye está registrado; de lo contrario, false.
Comentarios
Llame a este método antes de llamar al RegisterClientScriptInclude método para evitar registrar scripts duplicados. Esto es especialmente importante si el script requiere una gran cantidad de recursos de servidor para crear.
Un script de cliente incluye se identifica de forma única por su clave y su tipo. Los scripts con la misma clave y tipo se consideran duplicados.
Esta sobrecarga del IsStartupScriptRegistered método llama a la sobrecarga que toma un key parámetro y type con el tipo establecido como un Page objeto .
Consulte también
Se aplica a
IsClientScriptIncludeRegistered(Type, String)
Determina si el script de cliente incluye está registrado con el Page objeto mediante una clave y un tipo.
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 BooleanParámetros
- type
- Type
El tipo del script de cliente incluye para buscar.
- key
- String
La clave del script de cliente incluye para buscar.
Devoluciones
true si el script de cliente incluye está registrado; de lo contrario, false.
Excepciones
El tipo de inclusión del script de cliente es null.
Ejemplos
En el ejemplo de código siguiente se muestra el uso del IsClientScriptIncludeRegistered método . Tenga en cuenta que, si se quitó la lógica para comprobar la inclusión del script de cliente existente, no habría dos scripts de cliente duplicados en el código fuente HTML de la página representada porque el RegisterClientScriptInclude método comprueba si hay duplicados. La ventaja de comprobar es reducir el cálculo innecesario.
<%@ 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>
En este ejemplo se requiere un archivo JavaScript denominado Script_include.js, con el siguiente contenido:
function DoClick() {Form1.Message.value='Text from include script.'}
Comentarios
Llame a este método antes de llamar al RegisterClientScriptInclude método para evitar registrar los scripts de cliente duplicados. Esto es especialmente importante si el script requiere una gran cantidad de recursos de servidor para crear.
Un script de cliente incluye se identifica de forma única por su clave y su tipo. Los scripts con la misma clave y tipo se consideran duplicados. Especifique el tipo basado en el objeto al que se accederá al recurso. Por ejemplo, cuando se usa una instancia de Page para acceder al recurso, se especifica el Page tipo .