ScriptManager.RegisterStartupScript ScriptManager.RegisterStartupScript ScriptManager.RegisterStartupScript Method

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) RegisterStartupScript(Control, Type, String, String, Boolean) 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) 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.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) RegisterStartupScript(Control, Type, String, String, Boolean) 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 Control

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

type
Type 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 String String

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

script
String String String

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

addScriptTags
Boolean Boolean 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.

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

Usa el RegisterStartupScript método 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 ninguna dependencia de Microsoft Ajax Library.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. Bloques de script de inicio que se registran 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.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 el 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 pertenecen a las actualizaciones parciales de página y, si desea registrar el script sólo una vez durante la representación de página inicial, utilice el RegisterStartupScript método de la ClientScriptManager clase.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 a la ClientScriptManager objeto desde el ClientScript propiedad 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 se representa mediante el RegisterStartupScript método se ejecuta cuando la página termine de cargarse, pero antes de que el cliente de la página onload provoca el evento.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. Bloques de script de inicio se encuentra en la parte inferior de la página ASP.NET representada justo antes del </form> etiqueta.Startup script blocks are located at the bottom of the rendered ASP.NET page just before the </form> tag.

Bloques de script de inicio que se registran mediante RegisterStartupScript no se garantiza que se generan en el mismo orden en 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 es importante el orden de los bloques de script de inicio, use un StringBuilder para recopilar los bloques de script en una sola cadena de objetos y, a continuación, registrarlos todos como un script de inicio único.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) 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.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 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 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 String String

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

script
String String String

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

addScriptTags
Boolean Boolean 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

Utilice este método 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 UpdatePanel controlar de manera que se registra el bloque de script solo cuando el UpdatePanel control se actualiza, use el RegisterStartupScript(Control, Type, String, String, Boolean) sobrecarga 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 pertenecen a las actualizaciones parciales de página y, si desea registrar el script sólo una vez durante la representación de página inicial, utilice el RegisterStartupScript método de la ClientScriptManager clase.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 a la ClientScriptManager objeto desde el ClientScript propiedad 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