Share via

Cómo: Agregar secuencias de comandos de cliente a las páginas Web ASP.NET dinámicamente

  • Artículo

Actualización: noviembre 2007

El uso de código del servidor permite agregar secuencias de comandos de cliente a una página. La creación de secuencias de comandos de cliente en el código del servidor es útil cuando el contenido de dichas secuencias depende de información que únicamente está disponible en tiempo de ejecución. La adición de secuencias de comandos de cliente a la página de forma dinámica también resulta útil cuando se desea que dichas secuencias se ejecuten en las situaciones siguientes:

Para agregar secuencias de comandos de cliente a una página Web ASP.NET dinámicamente

  • En el código del servidor, llame a uno de los métodos mostrados en la tabla siguiente.

    Método

    Descripción

    RegisterClientScriptBlock

    Agrega un bloque de secuencias de comandos a la parte superior de la página. Cree la secuencia de comandos como una cadena y, a continuación, pásela al método, que la agregará a la página. Puede utilizar este método para insertar cualquier secuencia de comandos en la página. Tenga en cuenta que la secuencia de comandos se podría representar en la página antes de que terminen todos los elementos; por consiguiente, es posible que no pueda hacer referencia a todos los elementos de la página desde la secuencia de comandos.

    RegisterClientScriptInclude

    Similar al método RegisterClientScriptBlock, pero agrega un bloque de secuencias de comandos que hace referencia a un archivo .js externo. El archivo de inclusión se agrega antes que cualquier secuencia de comandos agregada dinámicamente; por consiguiente, es posible que no pueda hacer referencia a algunos de los elementos de la página.

    RegisterStartupScript

    Agrega un bloque de secuencias de comandos a la página que se ejecuta cuando finaliza la carga de ésta, pero antes de que se produzca el evento onload. La secuencia de comandos no se suele crear como un controlador de eventos o una función; generalmente sólo incluye las instrucciones que se deben ejecutar una sola vez.

    RegisterOnSubmitStatement

    Agrega una secuencia de comandos que se ejecuta en respuesta al evento onsubmit de la página. La secuencia de comandos se ejecuta antes de que se envíe la página y ofrece la oportunidad de cancelar el envío.

    En el ejemplo de código siguiente se muestra cómo agregar una secuencia de comandos de cliente a una página que se ejecuta cuando el usuario hace clic en un botón que envía la página de nuevo al servidor. La secuencia de comandos de cliente muestra una ventana emergente que solicita al usuario que confirme la devolución de datos.

    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);
}

Vea también

Tareas

Cómo: Agregar eventos de secuencias de comandos de cliente a los controles de servidor Web ASP.NET

Conceptos

Script de cliente en páginas web ASP.NET

Implementar mediante programación devoluciones de llamada de cliente sin devoluciones de datos en páginas web de ASP.NET