ScriptManager.RegisterOnSubmitStatement ScriptManager.RegisterOnSubmitStatement ScriptManager.RegisterOnSubmitStatement Method

Definición

Registra código ECMAScript (JavaScript) que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code that is executed when the form is submitted.

Sobrecargas

RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String) RegisterOnSubmitStatement(Control, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script);
public static void RegisterOnSubmitStatement (System.Web.UI.Control control, Type type, string key, string script);
static member RegisterOnSubmitStatement : System.Web.UI.Control * Type * string * string -> unit

Parámetros

control
Control Control Control

Control que registra la instrucción onsubmit.The control that is registering the onsubmit statement.

type
Type Type Type

Tipo de la instrucción de script de cliente.The type of the client script statement. 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 para la instrucción de script.A unique identifier for the script statement.

script
String String String

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

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 RegisterOnSubmitStatement agrega la secuencia de comandos que se ejecuta antes de que se envía el formulario, que le permite modificar el envío o cancelarlo.The RegisterOnSubmitStatement adds script that is executed before the form is submitted, which lets you modify the submission or cancel it.

Usa el RegisterOnSubmitStatement método para representar un onsubmit instrucción que es compatible con la representación parcial de página y que no tiene ninguna dependencia de Microsoft Ajax Library.You use the RegisterOnSubmitStatement method to render an onsubmit statement that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. El código JavaScript que está registrado con este método se envía a la página solo cuando el control que registra la instrucción está dentro de un UpdatePanel control que se está actualizando.JavaScript code that is registered by using this method is sent to the page only when the control that is registering the statement is inside an UpdatePanel control that is being updated. Para registrar el código con cada postback asincrónico, utilice el RegisterOnSubmitStatement(Page, Type, String, String) sobrecarga de este método.To register code with every asynchronous postback, use the RegisterOnSubmitStatement(Page, Type, String, String) overload of this method.

Si desea registrar código JavaScript que no pertenecen a las actualizaciones parciales de página y, si desea registrar el código solo una vez durante la representación de página inicial, use el RegisterOnSubmitStatement método de la ClientScriptManager clase.If you want to register JavaScript code that does not pertain to partial-page updates, and if you want to register the code only one time during initial page rendering, use the RegisterOnSubmitStatement 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 script parámetro de la RegisterOnSubmitStatement el método puede contener varias secuencias de comandos que se delimitan con punto y coma (;).The script parameter of the RegisterOnSubmitStatement method can contain multiple script commands that are delimited by using semicolons (;).

Para obtener más información acerca de los formularios HTML y el onsubmit eventos, consulte el sitio Web de World Wide Web Consortium (W3C).For more information about HTML forms and the onsubmit event, see the World Wide Web Consortium (W3C) Web site.

Consulte también:

RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String) RegisterOnSubmitStatement(Page, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se utiliza con un control UpdatePanel que se ejecuta cuando se envía el formulario.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

public:
 static void RegisterOnSubmitStatement(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script);
public static void RegisterOnSubmitStatement (System.Web.UI.Page page, Type type, string key, string script);
static member RegisterOnSubmitStatement : System.Web.UI.Page * Type * string * string -> unit

Parámetros

page
Page Page Page

Objeto de página que registra la instrucción onsubmit.The page object that is registering the onsubmit statement.

type
Type Type Type

Tipo de la instrucción de script de cliente.The type of the client script statement. 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 para la instrucción de script.A unique identifier for the script statement.

script
String String String

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

Excepciones

page es null.page is null.

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

Comentarios

Registrar código JavaScript con este método hace que el script se incluye cada vez que se produce un postback asincrónico.Registering JavaScript code with this method causes the script to be included every time that an asynchronous postback occurs.

Nota

No se quita el código desde cualquier postbacks asincrónicos anteriormente.Code from any earlier asynchronous postbacks is not removed. Nuevo postbacks asincrónicos anexe el código para código existente para el onsubmit instrucción.New asynchronous postbacks append code to any existing code for the onsubmit statement.

Para registrar el código para un control que está dentro de un UpdatePanel controlar de manera que se registra el código solo cuando el UpdatePanel control se actualiza, use el RegisterOnSubmitStatement(Control, Type, String, String) sobrecarga de este método.To register code for a control that is inside an UpdatePanel control so that the code is registered only when the UpdatePanel control is updated, use the RegisterOnSubmitStatement(Control, Type, String, String) overload of this method.

Si desea registrar código JavaScript que no pertenecen a las actualizaciones parciales de página y, si desea registrar el código solo una vez durante la representación de página inicial, use el RegisterOnSubmitStatement método de la ClientScriptManager clase.If you want to register JavaScript code that does not pertain to partial-page updates, and if you want to register the code only one time during initial page rendering, use the RegisterOnSubmitStatement 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