ScriptManager.RegisterOnSubmitStatement Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.Extensions.dll

Regista código ECMAScript (JavaScript) que é executado quando o formulário é submetido.

Sobrecargas

Name Description
RegisterOnSubmitStatement(Page, Type, String, String)

Regista código ECMAScript (JavaScript) com o ScriptManager controlo de um controlo que é usado com um UpdatePanel controlo executado quando o formulário é submetido.
RegisterOnSubmitStatement(Control, Type, String, String)

Regista código ECMAScript (JavaScript) com o ScriptManager controlo de um controlo que é usado com um UpdatePanel controlo executado quando o formulário é submetido.

RegisterOnSubmitStatement(Page, Type, String, String)

Regista código ECMAScript (JavaScript) com o ScriptManager controlo de um controlo que é usado com um UpdatePanel controlo executado quando o formulário é submetido.

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 página que regista a onsubmit instrução.

type
Type

O tipo da instrução do script do cliente. Este parâmetro é normalmente especificado usando o operador typeof (C#) ou o operador GetType (Visual Basic) para recuperar o tipo do controlo que está a registar o script.

key
String

Um identificador único para a instrução script.

script
String

O guião para registar.

Exceções

ArgumentNullException

page é null.

-ou-

type é null.

Observações

Registar código JavaScript com este método faz com que o script seja incluído sempre que ocorre um postback assíncrono.

Note

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

Para registar código para um controlo que está dentro de um UpdatePanel controlo, de modo a que o código só seja registado quando o UpdatePanel controlo é atualizado, use a RegisterOnSubmitStatement(Control, Type, String, String) sobrecarga deste método.

Se quiser registar código JavaScript que não esteja relacionado com atualizações parciais de páginas, e se quiser registar o código apenas uma vez durante a renderização inicial da página, use o RegisterOnSubmitStatement método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.

Ver também

Aplica-se a

RegisterOnSubmitStatement(Control, Type, String, String)

Regista código ECMAScript (JavaScript) com o ScriptManager controlo de um controlo que é usado com um UpdatePanel controlo executado quando o formulário é submetido.

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 controlo que regista a onsubmit instrução.

type
Type

O tipo da instrução do script do cliente. Este parâmetro é normalmente especificado usando o operador typeof (C#) ou o operador GetType (Visual Basic) para recuperar o tipo do controlo que está a registar o script.

key
String

Um identificador único para a instrução script.

script
String

O guião para registar.

Exceções

ArgumentNullException

control é null.

-ou-

type é null.

ArgumentException

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

Observações

O RegisterOnSubmitStatement script de adições que é executado antes do formulário ser submetido, que permite modificar ou cancelar a submissão.

Utiliza-se o método RegisterOnSubmitStatement para renderizar uma instrução onsubmit que é compatível com renderização parcial de página e que não tem dependências Microsoft da Ajax Library. O código JavaScript registado através deste método só é enviado para a página quando o controlo que regista a instrução está dentro de um UpdatePanel controlo que está a ser atualizado. Para registar código com cada postback assíncrono, use a RegisterOnSubmitStatement(Page, Type, String, String) sobrecarga deste método.

Se quiser registar código JavaScript que não esteja relacionado com atualizações parciais de páginas, e se quiser registar o código apenas uma vez durante a renderização inicial da página, use o RegisterOnSubmitStatement método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.

O parâmetro de script do RegisterOnSubmitStatement método pode conter múltiplos comandos de script que são delimitados pelo uso de ponto e vírgula (;).

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

Ver também

Aplica-se a