Propriété UseSubmitBehavior d'ASP.NET

Définition et utilisation

L'attribut UseSubmitBehavior spécifie si le contrôle de bouton utilise la fonctionnalité de soumission intégrée du navigateur client ou le mécanisme de postback d'ASP.NET.

Cette propriété est définie sur TRUE si le contrôle utilise le mécanisme de soumission du navigateur. Sinon, il est FALSE. La valeur par défaut est TRUE.

Lorsqu'il est réglé sur FALSE, ASP.NET ajoute un script client pour renvoyer ce formulaire.

Lorsque l'attribut UseSubmitBehavior est faux, le développeur du contrôle peut utiliser la méthode GetPostBackEventReference pour retourner l'événement de renvoi client du Button. La méthode GetPostBackEventReference retourne une chaîne contenant le texte de l'appel de fonction client, qui peut être inséré dans le programmeur d'événement client.

Syntaxe

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

Exemple

L'exemple suivant utilise le mécanisme de postback d'ASP.NET :

<script runat="server">
Procédure SubmitBtn(obj As Object, e As EventArgs)
  lblMsg.Text = "Soumis en utilisant le mécanisme de postback ASP.NET."
Fin Sub
</script>
<form runat="server">
Cliquez sur le bouton :
<asp:button id="Button1" runat="server"
Text="Submit" onclick="SubmitBtn" 
UseSubmitBehavior="FALSE" />
<br />
<asp:label id="lblMsg" runat="server"/>
</form>

Exemple

Utilisation du mécanisme de postback d'ASP.NET sur le contrôle button