ScriptManager.RegisterOnSubmitStatement Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registra o código ECMAScript (JavaScript) executado quando o formulário é enviado.

Sobrecargas

RegisterOnSubmitStatement(Page, Type, String, String)	Registra o código ECMAScript (JavaScript) com o controle ScriptManager para um controle usado com um controle UpdatePanel executado quando o formulário é enviado.
RegisterOnSubmitStatement(Control, Type, String, String)	Registra o código ECMAScript (JavaScript) com o controle ScriptManager para um controle usado com um controle UpdatePanel executado quando o formulário é enviado.

RegisterOnSubmitStatement(Page, Type, String, String)

Registra o código ECMAScript (JavaScript) com o controle ScriptManager para um controle usado com um controle UpdatePanel executado quando o formulário é enviado.

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

O objeto de página que está registrando a instrução onsubmit.

type

Type

O tipo da instrução de script de cliente. Geralmente, este parâmetro é especificado com o operador typeof (C#) ou GetType (Visual Basic) para recuperar o tipo do controle que está registrando o script.

key

String

Um identificador exclusivo para a declaração do script.

script

String

O script a ser registrado.

Exceções

ArgumentNullException

page é null.

- ou - type é null.

Comentários

Registrar código JavaScript com esse método faz com que o script seja incluído sempre que um postback assíncrono ocorrer.

Observação

O código de quaisquer postbacks assíncronos anteriores não é removido. Novos postbacks assíncronos acrescentam código a qualquer código existente para a onsubmit instrução.

Para registrar o código de um controle que está dentro de um UpdatePanel controle para que o código seja registrado somente quando o UpdatePanel controle for atualizado, use a RegisterOnSubmitStatement(Control, Type, String, String) sobrecarga desse método.

Se você quiser registrar o código JavaScript que não pertence a atualizações de página parcial e se quiser registrar o código apenas uma vez durante a renderização inicial da página, use o RegisterOnSubmitStatement método da ClientScriptManager classe. Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

Confira também

• RegisterOnSubmitStatement(Control, Type, String, String)

RegisterOnSubmitStatement(Control, Type, String, String)

Registra o código ECMAScript (JavaScript) com o controle ScriptManager para um controle usado com um controle UpdatePanel executado quando o formulário é enviado.

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

O controle que está registrando a instrução onsubmit.

type

Type

O tipo da instrução de script de cliente. Geralmente, este parâmetro é especificado com o operador typeof (C#) ou GetType (Visual Basic) para recuperar o tipo do controle que está registrando o script.

key

String

Um identificador exclusivo para a declaração do script.

script

String

O script a ser registrado.

Exceções

ArgumentNullException

control é null.

- ou - type é null.

ArgumentException

control não está na árvore de controle da página.

Comentários

O RegisterOnSubmitStatement script adiciona que é executado antes do formulário ser enviado, o que permite modificar o envio ou cancelá-lo.

Você usa o RegisterOnSubmitStatement método para renderizar uma instrução onsubmit compatível com a renderização de página parcial e que não tem dependências da Biblioteca do Microsoft Ajax. O código JavaScript registrado usando esse método é enviado para a página somente quando o controle que está registrando a instrução estiver dentro de um UpdatePanel controle que está sendo atualizado. Para registrar o código com cada postback assíncrono, use a RegisterOnSubmitStatement(Page, Type, String, String) sobrecarga desse método.

Se você quiser registrar o código JavaScript que não pertence a atualizações de página parcial e se quiser registrar o código apenas uma vez durante a renderização inicial da página, use o RegisterOnSubmitStatement método da ClientScriptManager classe. Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

O parâmetro de script do RegisterOnSubmitStatement método pode conter vários comandos de script delimitados usando ponto-e-vírgula (;).

Para obter mais informações sobre formulários HTML e o onsubmit evento, consulte o site do W3C (World Wide Web Consortium).

Confira também

• RegisterOnSubmitStatement(Page, Type, String, String)