ScriptManager.RegisterOnSubmitStatement Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
Aplica-se a
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
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).