ScriptManager.RegisterOnSubmitStatement Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.Extensions.dll

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

Sobrecargas

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

RegisterOnSubmitStatement(Page, Type, String, String)

Registra el código ECMAScript (JavaScript) con el ScriptManager control de un control que se usa con un UpdatePanel control 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 onsubmit instrucción .

type

Type

Tipo de la instrucción de script de cliente. Normalmente, este parámetro se especifica mediante el operador typeof (C#) o el operador GetType (Visual Basic) para recuperar el tipo del control que registra el script.

key

String

Identificador único de 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 el código de 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á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 . 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 el código ECMAScript (JavaScript) con el ScriptManager control de un control que se usa con un UpdatePanel control 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 onsubmit instrucción .

type

Type

Tipo de la instrucción de script de cliente. Normalmente, este parámetro se especifica mediante el operador typeof (C#) o el operador GetType (Visual Basic) para recuperar el tipo del control que registra el script.

key

String

Identificador único de 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 control de la página.

Comentarios

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

El método se usa RegisterOnSubmitStatement para representar una onsubmit instrucción compatible con la representación parcial de páginas y que no tiene dependencias de la biblioteca de Microsoft Ajax. 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á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 . Puede obtener una referencia al ClientScriptManager objeto desde la ClientScript propiedad de la página.

El parámetro de script del RegisterOnSubmitStatement método puede contener varios comandos de script que se delimitan 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)