ClientScriptManager.IsStartupScriptRegistered Método

Definição

Determina se o script de inicialização está registrado com o objeto Page.Determines whether the startup script is registered with the Page object.

Sobrecargas

IsStartupScriptRegistered(Type, String)

Determina se script de inicialização está registrado com o objeto Page usando o tipo e a chave especificados.Determines whether the startup script is registered with the Page object using the specified key and type.

IsStartupScriptRegistered(String)

Determina se o script de inicialização está registrado com o objeto Page usando a chave especificada.Determines whether the startup script is registered with the Page object using the specified key.

IsStartupScriptRegistered(Type, String)

Determina se script de inicialização está registrado com o objeto Page usando o tipo e a chave especificados.Determines whether the startup script is registered with the Page object using the specified key and type.

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.The type of the startup script to search for.

key
String

A chave de script de inicialização a ser pesquisada.The key of the startup script to search for.

Retornos

Boolean

true se o script de inicialização está registrado; caso contrário, false.true if the startup script is registered; otherwise, false.

Exceções

O tipo de script de inicialização é null.The startup script type is null.

Exemplos

O exemplo de código a seguir demonstra o uso do IsStartupScriptRegistered método.The following code example demonstrates the use of the IsStartupScriptRegistered method. 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.Note that, if the logic to check for the existing startup script block were removed, there would not be two duplicate startup scripts in the HTML source code of the rendered page because the RegisterStartupScript method checks for duplicates. O benefício da verificação é reduzir a computação desnecessária.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>

Comentários

Chame esse método antes de chamar o RegisterStartupScript método para evitar o registro de scripts duplicados.Call this method before calling the RegisterStartupScript method to avoid registering duplicate scripts. Isso é particularmente importante se o script exigir uma grande quantidade de recursos do servidor a serem criados.This is particularly important if the script requires a large amount of server resources to create.

Um script de inicialização do cliente é identificado exclusivamente por sua chave e seu tipo.A client startup script is uniquely identified by its key and its type. Scripts com a mesma chave e tipo são considerados duplicatas.Scripts with the same key and type are considered duplicates.

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.Determines whether the startup script is registered with the Page object using the specified key.

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.The key of the startup script to search for.

Retornos

Boolean

true se o script de inicialização está registrado; caso contrário, false.true if the startup script is registered; otherwise, false.

Comentários

Chame esse método antes de chamar o RegisterStartupScript método para evitar o registro de scripts duplicados.Call this method before calling the RegisterStartupScript method to avoid registering duplicate scripts. Isso é particularmente importante se o script exigir uma grande quantidade de recursos do servidor a serem criados.This is particularly important if the script requires a large amount of server resources to create.

Um script de inicialização é identificado exclusivamente por sua chave e seu tipo.A startup script is uniquely identified by its key and its type. Scripts com a mesma chave e tipo são considerados duplicatas.Scripts with the same key and type are considered duplicates.

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 objetoThis overload of the IsStartupScriptRegistered method calls the overload that takes both a string key and a type parameter with the type set as a Page object

Confira também

Aplica-se a