ScriptManager.RegisterStartupScript Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.Extensions.dll

Registra un bloque de script de inicio con el control ScriptManager y agrega el bloque de script a la página.

Sobrecargas

RegisterStartupScript(Control, Type, String, String, Boolean)	Registra un bloque de script de inicio para un control que está dentro de UpdatePanel con el control ScriptManager y agrega el bloque de script a la página.
RegisterStartupScript(Page, Type, String, String, Boolean)	Registra un bloque de script de inicio para cada postback asincrónico con el control ScriptManager y agrega el bloque de script a la página.

RegisterStartupScript(Control, Type, String, String, Boolean)

Registra un bloque de script de inicio para un control que está dentro de UpdatePanel con el control ScriptManager y agrega el bloque de script a la página.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript (System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parámetros

control

Control

Control que registra el bloque de script de cliente.

type

Type

Tipo del bloque de script de cliente. Este parámetro se suele especificar mediante el uso del operador typeof (C#) o GetType (Visual Basic) para recuperar el tipo del control que registra el script.

key

String

Identificador único del bloque de script.

script

String

Script que se va a registrar.

addScriptTags

Boolean

true para incluir el bloque de script entre etiquetas <script> y </script>; de lo contrario, false.

Excepciones

ArgumentNullException

control es null.

O bien type es null.

ArgumentException

control no está en el árbol de controles de la página.

Comentarios

Use el RegisterStartupScript método para registrar un bloque de script de inicio para una página compatible con la representación parcial de páginas y que no tenga dependencias de la biblioteca de Microsoft Ajax. Los bloques de script de inicio registrados mediante este método se envían a la página solo cuando el control que registra el bloque está dentro de un UpdatePanel control que se está actualizando. Para registrar un bloque de script de inicio cada vez que se produce un postback asincrónico, use la RegisterStartupScript(Page, Type, String, String, Boolean) sobrecarga de este método.

Si desea registrar un script de inicio que no pertenece a actualizaciones parciales de páginas y si desea registrar el script solo una vez durante la representación de página inicial, use el RegisterStartupScript método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

El bloque de script representado por el RegisterStartupScript método se ejecuta cuando la página finaliza la carga, pero antes de que se genere el evento de cliente onload de la página. Los bloques de script de inicio se encuentran en la parte inferior de la página ASP.NET representada justo antes de la </form> etiqueta .

No se garantiza que los bloques de script de inicio registrados mediante el uso RegisterStartupScript sean de salida en el mismo orden en el que están registrados. Si el orden de los bloques de script de inicio es importante, use un StringBuilder objeto para recopilar los bloques de script en una sola cadena y, a continuación, regístrelos todos como un único script de inicio.

Consulte también

• RegisterStartupScript(Page, Type, String, String, Boolean)

RegisterStartupScript(Page, Type, String, String, Boolean)

Registra un bloque de script de inicio para cada postback asincrónico con el control ScriptManager y agrega el bloque de script a la página.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript (System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parámetros

page

Page

Objeto de página que registra el bloque de script de cliente.

type

Type

Tipo del bloque de script de cliente. Este parámetro se suele especificar mediante el uso del operador typeof (C#) o GetType (Visual Basic) para recuperar el tipo del control que registra el script.

key

String

Identificador único del bloque de script.

script

String

Script que se va a registrar.

addScriptTags

Boolean

true para incluir el bloque de script entre etiquetas <script> y </script>; de lo contrario, false.

Comentarios

Este método se usa para registrar un bloque de script de inicio que se incluye cada vez que se produce una postback asincrónica. Para registrar un bloque de script para un control que se encuentra dentro de un UpdatePanel control para que el bloque de script solo se registre cuando se actualice el UpdatePanel control, use la RegisterStartupScript(Control, Type, String, String, Boolean) sobrecarga de este método.

Si desea registrar un script de inicio que no pertenece a actualizaciones parciales de páginas y si desea registrar el script solo una vez durante la representación de página inicial, use el RegisterStartupScript método de la ClientScriptManager clase . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

Consulte también

• RegisterStartupScript(Control, Type, String, String, Boolean)