ClientScriptManager.IsClientScriptBlockRegistered ClientScriptManager.IsClientScriptBlockRegistered ClientScriptManager.IsClientScriptBlockRegistered ClientScriptManager.IsClientScriptBlockRegistered Method

Definición

Determina si el bloque de script de cliente se encuentra registrado con el objeto Page.Determines whether the client script block is registered with the Page object.

Sobrecargas

IsClientScriptBlockRegistered(String) IsClientScriptBlockRegistered(String) IsClientScriptBlockRegistered(String) IsClientScriptBlockRegistered(String)

Determina si el bloque de script de cliente se encuentra registrado con el objeto Page utilizando la clave especificada.Determines whether the client script block is registered with the Page object using the specified key.

IsClientScriptBlockRegistered(Type, String) IsClientScriptBlockRegistered(Type, String) IsClientScriptBlockRegistered(Type, String)

Determina si el bloque de script de cliente se encuentra registrado con el objeto Page utilizando una clave y un tipo.Determines whether the client script block is registered with the Page object using a key and type.

IsClientScriptBlockRegistered(String) IsClientScriptBlockRegistered(String) IsClientScriptBlockRegistered(String) IsClientScriptBlockRegistered(String)

Determina si el bloque de script de cliente se encuentra registrado con el objeto Page utilizando la clave especificada.Determines whether the client script block is registered with the Page object using the specified key.

public:
 bool IsClientScriptBlockRegistered(System::String ^ key);
public bool IsClientScriptBlockRegistered (string key);
member this.IsClientScriptBlockRegistered : string -> bool
Public Function IsClientScriptBlockRegistered (key As String) As Boolean

Parámetros

key
String String String String

Clave del bloque de script de cliente que se va a buscar.The key of the client script block to search for.

Devoluciones

Es true si el bloque de script de cliente está registrado; en caso contrario, es false.true if the client script block is registered; otherwise, false.

Ejemplos

<%@ 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 and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString());
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 and type of the client scripts on the page.
    Dim csname1 As String = "PopupScript"
    Dim csname2 As String = "ButtonClickScript"
    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 startup script is already registered.
    If (Not cs.IsStartupScriptRegistered(cstype, csname1)) Then
      
      Dim cstext1 As String = "alert('Hello World');"
            cs.RegisterStartupScript(cstype, csname1, cstext1)
      
    End If
    
    ' Check to see if the client script is already registered.
    If (Not cs.IsClientScriptBlockRegistered(cstype, csname2)) Then
      
      Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
      cstext2.Append("Form1.Message.value='Text from client script.'} </")
      cstext2.Append("script>")
            cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString())
      
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>

Comentarios

Llame a este método antes de RegisterClientScriptBlock llamar al método para evitar el registro de scripts duplicados.Call this method before calling the RegisterClientScriptBlock method to avoid registering duplicate scripts. Esto es especialmente importante si el script requiere una gran cantidad de recursos del servidor que crear.This is particularly important if the script requires a large amount of server resources to create.

Un script de cliente se identifica de forma única mediante su clave y su tipo.A client script is uniquely identified by its key and its type. Los scripts con la misma clave y tipo se consideran duplicados.Scripts with the same key and type are considered duplicates.

Esta sobrecarga del IsClientScriptBlockRegistered método llama a la sobrecarga que toma type un key parámetro y con el tipo establecido como un Page objeto.This overload of the IsClientScriptBlockRegistered method calls the overload that takes both a key and a type parameter with the type set as a Page object

Consulte también:

IsClientScriptBlockRegistered(Type, String) IsClientScriptBlockRegistered(Type, String) IsClientScriptBlockRegistered(Type, String)

Determina si el bloque de script de cliente se encuentra registrado con el objeto Page utilizando una clave y un tipo.Determines whether the client script block is registered with the Page object using a key and type.

public:
 bool IsClientScriptBlockRegistered(Type ^ type, System::String ^ key);
public bool IsClientScriptBlockRegistered (Type type, string key);
member this.IsClientScriptBlockRegistered : Type * string -> bool

Parámetros

type
Type Type Type Type

Tipo del bloque de script de cliente que se va a buscar.The type of the client script block to search for.

key
String String String String

Clave del bloque de script de cliente que se va a buscar.The key of the client script block to search for.

Devoluciones

Es true si el bloque de script de cliente está registrado; en caso contrario, es false.true if the client script block is registered; otherwise, false.

Excepciones

El tipo de script de cliente es null.The client script type is null.

Ejemplos

En el ejemplo de código siguiente se muestra el IsClientScriptBlockRegistered uso del método.The following code example demonstrates the use of the IsClientScriptBlockRegistered method. Tenga en cuenta que, si se quitó la lógica para comprobar el bloque de script de cliente existente, no habrá dos scripts de cliente duplicados en el código fuente HTML de la RegisterClientScriptBlock página representada porque el método comprueba si existen duplicados.Note that, if the logic to check for the existing client script block were removed, there would not be two duplicate client scripts in the HTML source code of the rendered page because the RegisterClientScriptBlock method checks for duplicates. La ventaja de comprobar es reducir el cálculo innecesario.The benefit of checking is to reduce unnecessary computation.

<%@ 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 and type of the client scripts on the page.
    String csname1 = "PopupScript";
    String csname2 = "ButtonClickScript";
    Type cstype = this.GetType();
        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Check to see if the startup script is already registered.
    if (!cs.IsStartupScriptRegistered(cstype, csname1))
    {
      String cstext1 = "alert('Hello World');";
      cs.RegisterStartupScript(cstype, csname1, cstext1, true);
    }

    // Check to see if the client script is already registered.
    if (!cs.IsClientScriptBlockRegistered(cstype, csname2))
    {
      StringBuilder cstext2 = new StringBuilder();
      cstext2.Append("<script type=\"text/javascript\"> function DoClick() {");
      cstext2.Append("Form1.Message.value='Text from client script.'} </");
      cstext2.Append("script>");
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), false);
    }
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </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 and type of the client scripts on the page.
    Dim csname1 As String = "PopupScript"
    Dim csname2 As String = "ButtonClickScript"
    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 startup script is already registered.
    If (Not cs.IsStartupScriptRegistered(cstype, csname1)) Then
      
      Dim cstext1 As String = "alert('Hello World');"
      cs.RegisterStartupScript(cstype, csname1, cstext1, True)
      
    End If
    
    ' Check to see if the client script is already registered.
    If (Not cs.IsClientScriptBlockRegistered(cstype, csname2)) Then
      
      Dim cstext2 As New StringBuilder()
            cstext2.Append("<script type=""text/javascript""> function DoClick() {")
      cstext2.Append("Form1.Message.value='Text from client script.'} </")
      cstext2.Append("script>")
      cs.RegisterClientScriptBlock(cstype, csname2, cstext2.ToString(), False)
      
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form id="Form1"
         runat="server">
        <input type="text" id="Message" /> <input type="button" value="ClickMe" onclick="DoClick()" />
     </form>
  </body>
</html>

Comentarios

Llame a este método antes de RegisterClientScriptBlock llamar al método para evitar el registro de scripts duplicados.Call this method before calling the RegisterClientScriptBlock method to avoid registering duplicate scripts. Esto es especialmente importante si el script requiere una gran cantidad de recursos del servidor que crear.This is particularly important if the script requires a large amount of server resources to create.

Un script de cliente se identifica de forma única mediante su clave y su tipo.A client script is uniquely identified by its key and its type. Los scripts con la misma clave y tipo se consideran duplicados.Scripts with the same key and type are considered duplicates. Especifique el tipo basado en el objeto que va a tener acceso al recurso.You specify the type based on the object that will be accessing the resource. Por ejemplo, cuando se usa Page una instancia de para tener acceso al recurso, Page se especifica el tipo.For instance, when using a Page instance to access the resource, you specify the Page type.

Consulte también:

Se aplica a