Button.UseSubmitBehavior Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si el Button control usa el mecanismo de envío del explorador cliente o el mecanismo de postback del 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 de propiedad
true si el control usa el mecanismo de envío del explorador cliente; de lo contrario, false. El valor predeterminado es true.
- Atributos
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 se envía al servidor. La UseSubmitBehavior propiedad se establece falseen , lo que hace que el botón use el mecanismo de postback de 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 ASP.NET página 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
Use la UseSubmitBehavior propiedad para especificar si un Button control usa el mecanismo de envío del explorador cliente o el mecanismo de postback de 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 programadores de control pueden usar el GetPostBackEventReference método para devolver el evento postback del 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 ni temas de hojas de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.
