ScriptManager.RegisterStartupScript Método

Definición

Registra un bloque de script de inicio con el control ScriptManager y agrega el bloque de script a la página.Registers a startup script block with the ScriptManager control and adds the script block to the page.

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.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

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.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

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.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

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

Parámetros

control
Control

Control que registra el bloque de script de cliente.The control that is registering the client script block.

type
Type

Tipo del bloque de script de cliente.The type of the client script block. 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.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

key
String

Identificador único del bloque de script.A unique identifier for the script block.

script
String

El script que se va a registrar.The script to register.

addScriptTags
Boolean

true para incluir el bloque de script entre etiquetas <script> y </script>; de lo contrario, false.true to enclose the script block with <script> and </script> tags; otherwise, false.

Implementaciones

System.Web.UI.IScriptManager.RegisterStartupScript(System.Web.UI.Control,System.Type,System.String,System.String,System.Boolean)

Excepciones

control es null.control is null.

O bien-or- type es null.type is null.

control no está en el árbol de controles de la página.control is not in the page's control tree.

Comentarios

El método RegisterStartupScript se usa para registrar un bloque de script de inicio para una página que es compatible con la representación parcial de página y que no tiene dependencias de la biblioteca de Microsoft Ajax.You use the RegisterStartupScript method to register a startup script block for a page that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Los bloques de scripts de inicio que se registran con este método solo se envían a la página cuando el control que registra el bloque está dentro de un control UpdatePanel que se está actualizando.Startup script blocks that are registered by using this method are sent to the page only when the control that is registering the block is inside an UpdatePanel control that is being updated. Para registrar un bloque de script de inicio cada vez que se produce un postback asincrónico, utilice la RegisterStartupScript(Page, Type, String, String, Boolean) sobrecarga de este método.To register a startup script block every time that an asynchronous postback occurs, use the RegisterStartupScript(Page, Type, String, String, Boolean) overload of this method.

Si desea registrar un script de inicio que no se corresponde con las actualizaciones parciales de página, y si desea registrar el script solo una vez durante la representación inicial de la página, use el método RegisterStartupScript de la clase ClientScriptManager.If you want to register a startup script that does not pertain to partial-page updates, and if you want to register the script only one time during initial page rendering, use the RegisterStartupScript method of the ClientScriptManager class. Puede obtener una referencia al objeto ClientScriptManager desde la propiedad ClientScript de la página.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

El bloque de script que representa el método RegisterStartupScript se ejecuta cuando finaliza la carga de la página, pero antes de que se genere el evento de onload de cliente de la página.The script block that is rendered by the RegisterStartupScript method executes when the page finishes loading but before the page's client onload event is raised. Los bloques de scripts de inicio se encuentran en la parte inferior de la página representada ASP.NET justo antes de la etiqueta </form>.Startup script blocks are located at the bottom of the rendered ASP.NET page just before the </form> tag.

No se garantiza que los bloques de script de inicio que se registran mediante RegisterStartupScript se generen en el mismo orden en el que se registran.Startup script blocks that are registered by using RegisterStartupScript are not guaranteed to be output in the same order in which they are registered. Si el orden de los bloques de scripts de inicio es importante, use un objeto StringBuilder para recopilar los bloques de scripts en una sola cadena y, a continuación, regístrelo como un solo script de inicio.If the order of the startup script blocks is important, use a StringBuilder object to gather the script blocks in a single string, and then register them all as a single startup script.

Consulte también:

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.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

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

Parámetros

page
Page

Objeto de página que registra el bloque de script de cliente.The page object that is registering the client script block.

type
Type

Tipo del bloque de script de cliente.The type of the client script block. 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.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

key
String

Identificador único del bloque de script.A unique identifier for the script block.

script
String

El script que se va a registrar.The script to register.

addScriptTags
Boolean

true para incluir el bloque de script entre etiquetas <script> y </script>; de lo contrario, false.true to enclose the script block with <script> and </script> tags; otherwise, false.

Comentarios

Este método se usa para registrar un bloque de script de inicio que se incluye cada vez que se produce un postback asincrónico.You use this method to register a startup script block that is included every time that an asynchronous postback occurs. Para registrar un bloque de script para un control que está dentro de un control UpdatePanel de modo que el bloque de script se registre solo cuando se actualice el control UpdatePanel, utilice la sobrecarga RegisterStartupScript(Control, Type, String, String, Boolean) de este método.To register a script block for a control that is inside an UpdatePanel control so that the script block is registered only when the UpdatePanel control is updated, use the RegisterStartupScript(Control, Type, String, String, Boolean) overload of this method.

Si desea registrar un script de inicio que no se corresponde con las actualizaciones parciales de página, y si desea registrar el script solo una vez durante la representación inicial de la página, use el método RegisterStartupScript de la clase ClientScriptManager.If you want to register a startup script that does not pertain to partial-page updates, and if you want to register the script only one time during initial page rendering, use the RegisterStartupScript method of the ClientScriptManager class. Puede obtener una referencia al objeto ClientScriptManager desde la propiedad ClientScript de la página.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Consulte también:

Se aplica a