ASP.NET UseSubmitBehavior-Eigenschaft

Definition und Verwendung

Die Eigenschaft UseSubmitBehavior legt fest, ob der Button-Steuerelement die eingebauten Submit-Funktionen des Clientbrowsern verwendet oder das Postback-Mechanismus von ASP.NET.

Diese Eigenschaft wird auf TRUE gesetzt, wenn der Steuerelement die Submit-Mechanismen des Browsers verwendet. Andernfalls ist sie FALSE. Der Standardwert ist TRUE.

Wenn auf FALSE gesetzt, fügt ASP.NET ein Clienten-Skript hinzu, um das Formular zurückzuschicken.

Wenn die Eigenschaft UseSubmitBehavior auf false gesetzt ist, kann der Steuerelemententwickler die Methode GetPostBackEventReference verwenden, um den ClientenPostBack-Ereignis des Buttons zurückzugeben. Die von der Methode GetPostBackEventReference zurückgegebene Zeichenfolge enthält den Text der Clientenfunktionenaufrufe und kann in den Clientenereignisbehandlern eingefügt werden.

Syntax

<asp:Button UseSubmitBehavior="TRUE|FALSE" runat="server" />

Beispiel

Das folgende Beispiel verwendet den postback-Mechanismus von ASP.NET:

<script runat="server">
Sub SubmitBtn(obj As Object, e As EventArgs)
  lblMsg.Text = "Submitted using the ASP.NET postback mechanism."
End Sub
</script>
<form runat="server">
Klicken Sie auf die Schaltfläche:
<asp:button id="Button1" runat="server"
Text="Submit" onclick="SubmitBtn" 
UseSubmitBehavior="FALSE" />
<br />
<asp:label id="lblMsg" runat="server"/>
</form>

Beispiel

Die Verwendung des postback-Mechanismus von ASP.NET im button-Steuerelement