Button.UseSubmitBehavior Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se o controlo Button utiliza o mecanismo de submissão do navegador cliente ou o mecanismo de ASP.NET postback.
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 de Propriedade
true se o controlo usar o mecanismo de submissão do navegador cliente; caso contrário, false. A predefinição é true.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como usar a UseSubmitBehavior propriedade para especificar o mecanismo de submissão que um Button controlo utiliza quando é enviado de volta ao servidor. A propriedade UseSubmitBehavior está definida para false, fazendo com que o botão utilize o mecanismo de ASP.NET postback. Se visualizar o código-fonte da página renderizada usando o comando View Source do seu navegador, verá que o script do lado do cliente foi adicionado pelo framework da página ASP.NET para publicar 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>
Observações
Use a propriedade UseSubmitBehavior para especificar se um controlo Button utiliza o mecanismo de submissão do navegador cliente ou o mecanismo de postback ASP.NET. Por defeito, o valor desta propriedade é true, fazendo com que o Button controlo utilize o mecanismo de submissão do navegador. Se especificares false, o framework da página ASP.NET adiciona um script do lado do cliente à página para publicar o formulário no servidor.
Quando a UseSubmitBehavior propriedade é false, os desenvolvedores de controlo podem usar o GetPostBackEventReference método para devolver o evento de postback do cliente para o Button. A cadeia devolvida pelo GetPostBackEventReference método contém o texto da chamada de função do lado do cliente e pode ser inserida num gestor de eventos do lado do cliente.
Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.