Button.UseSubmitBehavior Propriedade
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.
Obtém ou define um valor que indica se o Button controle usa o mecanismo de envio do navegador cliente ou o mecanismo de postback ASP.NET.
public:
virtual property bool UseSubmitBehavior { bool get(); void set(bool value); };[System.Web.UI.Themeable(false)]
public virtual bool UseSubmitBehavior { get; set; }[<System.Web.UI.Themeable(false)>]
member this.UseSubmitBehavior : bool with get, setPublic Overridable Property UseSubmitBehavior As BooleanValor da propriedade
true se o controle usar o mecanismo de envio do navegador cliente; caso contrário, false. O padrão é true.
- Atributos
Exemplos
O exemplo de código a seguir demonstra como usar a UseSubmitBehavior propriedade para especificar o mecanismo de envio que um Button controle usa quando ele é postado novamente no servidor. A UseSubmitBehavior propriedade está definida como false, fazendo com que o botão use o mecanismo de postback ASP.NET. Se você exibir o código-fonte da página renderizada usando o comando Exibir Fonte do navegador, verá que o script do lado do cliente foi adicionado pela estrutura de página ASP.NET para postar o formulário no servidor.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void SubmitBtn_Click(object sender, EventArgs e)
{
Message.Text = "Hello World!";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Button.UseSubmitBehavior Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.UseSubmitBehavior Example</h3>
Click the Submit button.
<br /><br />
<!--The value of the UseSubmitBehavior property
is false. Therefore the button uses the ASP.NET
postback mechanism.-->
<asp:button id="Button1"
text="Submit"
onclick="SubmitBtn_Click"
usesubmitbehavior="false"
runat="server"/>
<br /><br />
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
Message.Text = "Hello World!"
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button.UseSubmitBehavior Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Button.UseSubmitBehavior Example</h3>
Click the Submit button.
<br /><br />
<!--The value of the UseSubmitBehavior property
is false. Therefore the button uses the ASP.NET
postback mechanism.-->
<asp:button id="Button1"
text="Submit"
onclick="SubmitBtn_Click"
usesubmitbehavior="false"
runat="server"/>
<br /><br />
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
Comentários
Use a UseSubmitBehavior propriedade para especificar se um Button controle usa o mecanismo de envio do navegador cliente ou o mecanismo de postback ASP.NET. Por padrão, o valor dessa propriedade é true, fazendo com que o Button controle use o mecanismo de envio do navegador. Se você especificar false, a estrutura de página ASP.NET adicionará o script do lado do cliente à página para postar o formulário no servidor.
Quando a UseSubmitBehavior propriedade é false, os desenvolvedores de controle podem usar o GetPostBackEventReference método para retornar o evento de postback do cliente para o Button. A cadeia de caracteres retornada pelo GetPostBackEventReference método contém o texto da chamada de função do lado do cliente e pode ser inserida em um manipulador de eventos do lado do cliente.
Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.
