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 la inclusión de script de cliente se encuentra registrada con el objeto Page.
Sobrecargas
| IsClientScriptIncludeRegistered(String) |
Determina si la inclusión de script de cliente se encuentra registrada con el objeto Page utilizando la clave especificada. |
| IsClientScriptIncludeRegistered(Type, String) |
Determina si la inclusión de script de cliente se encuentra registrada con el objeto Page utilizando una clave y un tipo. |
IsClientScriptIncludeRegistered(String)
Determina si la inclusión de script de cliente se encuentra registrada con el objeto Page utilizando 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
Clave de la inclusión de script de cliente que se va a buscar.
Devoluciones
Es true si la inclusión de script de cliente está registrada; en caso contrario, es false.
Comentarios
Llame a este método antes de llamar al RegisterClientScriptInclude método para evitar el registro de scripts duplicados. Esto es especialmente importante si el script requiere una gran cantidad de recursos de servidor para crear.
Un script de cliente incluye una identificación ú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 la inclusión de script de cliente se encuentra registrada con el objeto Page utilizando 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
Tipo de la inclusión de script de cliente que se va a buscar.
- key
- String
Clave de la inclusión de script de cliente que se va a buscar.
Devoluciones
Es true si la inclusión de script de cliente está registrada; en caso contrario, es false.
Excepciones
El tipo de inclusión de 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 el 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 el registro de 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 una identificación ú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 va a acceder al recurso. Por ejemplo, cuando se usa una instancia de Page para acceder al recurso, se especifica el Page tipo .