Button.UseSubmitBehavior Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece un valor que indica si el control Button utiliza el mecanismo de envío del explorador del cliente o el mecanismo de postback de 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 de propiedad

Boolean

Es true si el control utiliza el mecanismo de envío del explorador del cliente; de lo contrario, es false. De manera predeterminada, es true.

Atributos
ThemeableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la UseSubmitBehavior propiedad para especificar el mecanismo de envío que usa un Button control cuando vuelve a enviar al servidor. La UseSubmitBehavior propiedad se establece falseen , lo que hace que el botón use el mecanismo de postback ASP.NET. Si ve el código fuente de la página representada mediante el comando Ver origen del explorador, verá que el marco de página de ASP.NET ha agregado el script del lado cliente para publicar el formulario en el 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>

Comentarios

Utilice la UseSubmitBehavior propiedad para especificar si un Button control usa el mecanismo de envío del explorador cliente o el mecanismo de postback del ASP.NET. De forma predeterminada, el valor de esta propiedad es true, lo que hace que el Button control use el mecanismo de envío del explorador. Si especifica false, el marco de ASP.NET página agrega el script del lado cliente a la página para publicar el formulario en el servidor.

Cuando la UseSubmitBehavior propiedad es false, los desarrolladores de controles pueden usar el GetPostBackEventReference método para devolver el evento de postback de cliente para .Button La cadena devuelta por el GetPostBackEventReference método contiene el texto de la llamada de función del lado cliente y se puede insertar en un controlador de eventos del lado cliente.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también