Button.UseSubmitBehavior Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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 controle Button usa o mecanismo de envio do navegador do 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, set

Public Overridable Property UseSubmitBehavior As Boolean

Valor da propriedade

Boolean

true se o controle usa o mecanismo de enviar do navegador do cliente; caso contrário, false. O padrão é true.

Atributos: ThemeableAttribute

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 envia de volta para o servidor. A UseSubmitBehavior propriedade é definida falsecomo , 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 da 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 da página ASP.NET adicionará o script do lado do cliente à página para postar o formulário no servidor.

Quando a propriedade é false, os UseSubmitBehavior 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 Capas.

Aplica-se a

Partilhar via