Button.UseSubmitBehavior Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une valeur indiquant si le contrôle Button utilise le mécanisme d'envoi du navigateur client ou le mécanisme de publication 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

Valeur de propriété

Boolean

true si le contrôle utilise le mécanisme d'envoi du navigateur client ; sinon, false. La valeur par défaut est true.

Attributs
ThemeableAttribute

Exemples

L’exemple de code suivant montre comment utiliser la UseSubmitBehavior propriété pour spécifier le mécanisme d’envoi qu’un Button contrôle utilise lorsqu’il publie sur le serveur. La UseSubmitBehavior propriété est définie sur false, ce qui entraîne l’utilisation du bouton ASP.NET mécanisme de publication. Si vous affichez le code source de la page rendue à l’aide de la commande Afficher la source de votre navigateur, vous verrez que le script côté client a été ajouté par l’infrastructure de page ASP.NET pour publier le formulaire sur le serveur.

<%@ 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>

Remarques

Utilisez la UseSubmitBehavior propriété pour spécifier si un Button contrôle utilise le mécanisme d’envoi du navigateur client ou le mécanisme de publication ASP.NET. Par défaut, la valeur de cette propriété est true, ce qui oblige le Button contrôle à utiliser le mécanisme d’envoi du navigateur. Si vous spécifiez false, l’infrastructure de page ASP.NET ajoute un script côté client à la page pour publier le formulaire sur le serveur.

Lorsque la propriété a la UseSubmitBehavior valeur false, les développeurs de contrôle peuvent utiliser la GetPostBackEventReference méthode pour retourner l’événement de publication du client pour le Button. La chaîne retournée par la GetPostBackEventReference méthode contient le texte de l’appel de fonction côté client et peut être insérée dans un gestionnaire d’événements côté client.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et apparences.

S’applique à

Voir aussi