Compartir vía


ClientScriptManager.IsClientScriptIncludeRegistered Método

Definición

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 -> bool
Public Function IsClientScriptIncludeRegistered (key As String) As Boolean

Parámetros

key
String

Clave de la inclusión de script de cliente que se va a buscar.

Devoluciones

Boolean

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 -> bool
Public Function IsClientScriptIncludeRegistered (type As Type, key As String) As Boolean

Pará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

Boolean

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 .

Consulte también

Se aplica a