ClientScriptManager.IsStartupScriptRegistered Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Determina se o script de inicialização está registrado com o objeto Page.

Sobrecargas

IsStartupScriptRegistered(Type, String)

Determina se script de inicialização está registrado com o objeto Page usando o tipo e a chave especificados.
IsStartupScriptRegistered(String)

Determina se o script de inicialização está registrado com o objeto Page usando a chave especificada.

IsStartupScriptRegistered(Type, String)

Determina se script de inicialização está registrado com o objeto Page usando o tipo e a chave especificados.

public:
 bool IsStartupScriptRegistered(Type ^ type, System::String ^ key);
public bool IsStartupScriptRegistered (Type type, string key);
member this.IsStartupScriptRegistered : Type * string -> bool
Public Function IsStartupScriptRegistered (type As Type, key As String) As Boolean

Parâmetros

type
Type

O tipo de script de inicialização a ser pesquisado.

key
String

A chave de script de inicialização a ser pesquisada.

Retornos

Boolean

true se o script de inicialização está registrado; caso contrário, false.

Exceções

ArgumentNullException

O tipo de script de inicialização é null.

Exemplos

O exemplo de código a seguir demonstra o uso do IsStartupScriptRegistered método . Observe que, se a lógica para verificar o bloco de script de inicialização existente tiver sido removida, não haveria dois scripts de inicialização duplicados no código-fonte HTML da página renderizada porque o RegisterStartupScript método verifica se há duplicatas. O benefício da verificação é reduzir a computação desnecessária.

<%@ 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>

Comentários

Chame esse método antes de chamar o RegisterStartupScript método para evitar o registro de scripts duplicados. Isso é particularmente importante se o script exigir uma grande quantidade de recursos de servidor para criar.

Um script de inicialização de cliente é identificado exclusivamente por sua chave e seu tipo. Scripts com a mesma chave e tipo são considerados duplicados.

Confira também

Aplica-se a

IsStartupScriptRegistered(String)

Determina se o script de inicialização está registrado com o objeto Page usando a chave especificada.

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

Parâmetros

key
String

A chave de script de inicialização a ser pesquisada.

Retornos

Boolean

true se o script de inicialização está registrado; caso contrário, false.

Comentários

Chame esse método antes de chamar o RegisterStartupScript método para evitar o registro de scripts duplicados. Isso é particularmente importante se o script exigir uma grande quantidade de recursos de servidor para criar.

Um script de inicialização é identificado exclusivamente por sua chave e seu tipo. Scripts com a mesma chave e tipo são considerados duplicados.

Essa sobrecarga do IsStartupScriptRegistered método chama a sobrecarga que usa uma cadeia de caracteres key e um type parâmetro com o tipo definido como um Page objeto

Confira também

Aplica-se a