Como: Adicionar script de cliente dinamicamente a páginas da Web do ASP.NET

  • Artigo

Usando código do servidor, você pode adicionar script de cliente a uma página.A criação de script de cliente no código do servidor é útil quando o conteúdo de script de cliente depende de informações que não estão disponíveis até o tempo de execução.Adicionar script de cliente dinamicamente à página também é útil quando você deseja que script de cliente execute nas seguintes situações:

Para adicionar script de cliente um página da Web ASP.NET dinamicamente

  • Chame um dos métodos listado na tabela seguinte, em código de servidor.

    Método

    Descrição

    RegisterClientScriptBlock

    Adiciona um bloco de scripts a parte superior da página.Você deve criar o script como uma sequência de caracteres e passá-lo para o método, que irá adiciona-lo à página.Você pode usar esse método para inserir qualquer script na página.Observe que o script pode ser processado para a página antes que todos os elementos estejam concluídos; portanto, talvez não será possível fazer referência à todos os elementos na página a partir do script.

    RegisterClientScriptInclude

    Semelhante ao método RegisterClientScriptBlock, mas adiciona um bloco de scripts que faz referência a um arquivo .js externo.O arquivo de inclusão é adicionado antes de qualquer outro script adicionado dinamicamente; portanto, talvez não seja possível fazer referência à alguns elementos na página.

    RegisterStartupScript

    Adiciona um bloco de scripts para a página que é executado quando a página termina de ser carregada, mas antes que o evento onload da página seja gerado.O script não é normalmente criado como um manipulador de eventos ou função; ele geralmente inclui somente as instruções que você deseja executar uma vez.

    RegisterOnSubmitStatement

    Adiciona script que executam em resposta ao evento onsubmit da página.O script é executado antes da página ser enviada, e oferece a você a oportunidade para cancelar o envio.

    O exemplo de código a seguir mostra como adicionar script de cliente em uma página que executa quando o usuário clica em um botão que envia a página de volta para o servidor.O script de cliente exibe uma janela pop-up solicitando que o usuário confirme o postback.

    Protected Sub Page_Load(ByVal sender As Object, _
        ByVal e As System.EventArgs)
    Dim scriptText As String
    scriptText = "return confirm('Do you want to submit the page?')"
    ClientScript.RegisterOnSubmitStatement(Me.GetType(), _
        "ConfirmSubmit", scriptText)
End Sub

protected void Page_Load(Object sender, EventArgs e)
{
    String scriptText = 
        "return confirm('Do you want to submit the page?')";
    ClientScript.RegisterOnSubmitStatement(this.GetType(), 
        "ConfirmSubmit", scriptText);
}

Consulte também

Tarefas

Como: Adicionar cliente Script Events para controles de servidor Web do ASP.NET

Conceitos

Script de Cliente em Páginas da Web ASP.NET

Implementando Callbacks de Clientes Através de Programação Sem Postbacks nas Páginas ASP.NET