Propriedade UseSubmitBehavior do ASP.NET

Definição e uso

A propriedade UseSubmitBehavior define se o controle de botão deve usar a função de envio integrada do navegador cliente ou o mecanismo de postback do ASP.NET.

Esta propriedade é configurada como TRUE se o controle usar o mecanismo de envio do navegador. Caso contrário, é FALSE. O valor padrão é TRUE.

Quando definido como FALSE, o ASP.NET adiciona um pedaço de script do cliente para enviar o formulário de volta.

Quando o atributo UseSubmitBehavior for false, o desenvolvedor do controle pode usar o método GetPostBackEventReference para retornar o evento de envio do cliente do Button. O método GetPostBackEventReference retorna uma string que contém o texto da chamada da função do cliente, que pode ser inserida no manipulador de eventos do cliente.

Sintaxe

<asp:Button UseSubmitBehavior="TRUE|FALSE" runat="server" />

Exemplo

O exemplo a seguir utiliza o mecanismo de postback do ASP.NET:

<script runat="server">
Sub SubmitBtn(obj As Object, e As EventArgs)
  lblMsg.Text = "Submetido usando o mecanismo de postback do ASP.NET."
Fim Sub
</script>
<form runat="server">
Clique no botão:
<asp:button id="Button1" runat="server"
Text="Submit" onclick="SubmitBtn" 
UseSubmitBehavior="FALSE" />
<br />
<asp:label id="lblMsg" runat="server"/>
</form>

Exemplo

Uso do mecanismo de postback do ASP.NET no controle button