ScriptManager.RegisterOnSubmitStatement Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.Extensions.dll

Registra código ECMAScript (JavaScript) que se ejecuta cuando se envía el formulario.

Sobrecargas

RegisterOnSubmitStatement(Page, Type, String, String)	Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.
RegisterOnSubmitStatement(Control, Type, String, String)	Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.

RegisterOnSubmitStatement(Page, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.

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

Public Shared Sub RegisterOnSubmitStatement (page As Page, type As Type, key As String, script As String)

Parámetros

page

Page

Objeto de página que registra la instrucción onsubmit.

type

Type

Tipo de la instrucción 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 para la instrucción de script.

script

String

Script que se va a registrar.

Excepciones

ArgumentNullException

page es null.

o bien

type es null.

Comentarios

El registro de código JavaScript con este método hace que el script se incluya cada vez que se produzca una postback asincrónica.

Nota

No se quita el código de los postbacks asincrónicos anteriores. Los nuevos postbacks asincrónicos anexan código a cualquier código existente para la onsubmit instrucción .

Para registrar código para un control que está dentro de un UpdatePanel control para que el código se registre solo cuando se actualice el UpdatePanel control, use la RegisterOnSubmitStatement(Control, Type, String, String) sobrecarga de este método.

Si desea registrar código JavaScript que no pertenece a actualizaciones parciales de páginas 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 . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

Consulte también

• RegisterOnSubmitStatement(Control, Type, String, String)

RegisterOnSubmitStatement(Control, Type, String, String)

Registra código ECMAScript (JavaScript) con el control ScriptManager para un control que se usa con un control UpdatePanel que se ejecuta cuando se envía el formulario.

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

Public Shared Sub RegisterOnSubmitStatement (control As Control, type As Type, key As String, script As String)

Parámetros

control

Control

Control que registra la instrucción onsubmit.

type

Type

Tipo de la instrucción 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 para la instrucción de script.

script

String

Script que se va a registrar.

Excepciones

ArgumentNullException

control es null.

o bien

type es null.

ArgumentException

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

Comentarios

RegisterOnSubmitStatement Agrega el script que se ejecuta antes de enviar el formulario, lo que le permite modificar el envío o cancelarlo.

Use el RegisterOnSubmitStatement método para representar una onsubmit instrucción compatible con la representación parcial de páginas y que no tenga dependencias de la biblioteca de Ajax Microsoft. El código JavaScript registrado mediante 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. Para registrar código con cada postback asincrónico, use la RegisterOnSubmitStatement(Page, Type, String, String) sobrecarga de este método.

Si desea registrar código JavaScript que no pertenece a actualizaciones parciales de páginas 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 . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

El parámetro script del RegisterOnSubmitStatement método puede contener varios comandos de script delimitados mediante punto y coma (;).

Para obtener más información sobre los formularios HTML y el onsubmit evento, vea el sitio web de World Wide Web Consortium (W3C).

Consulte también

• RegisterOnSubmitStatement(Page, Type, String, String)