HtmlForm.DefaultButton Propriété

  • Référence

Définition

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

Obtient ou définit le contrôle enfant du contrôle HtmlForm qui provoque la publication lorsque la touche ENTRÉE est enfoncée.

public:
 property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
public string DefaultButton { get; set; }
member this.DefaultButton : string with get, set
Public Property DefaultButton As String

Valeur de propriété

String

ID du contrôle bouton à afficher comme bouton par défaut lorsque HtmlForm est chargé. La valeur par défaut est une chaîne vide ("").

Exceptions

InvalidOperationException

Le contrôle référencé comme bouton par défaut n'est pas du type IButtonControl.

Exemples

L’exemple suivant montre comment définir la DefaultButton propriété pour définir le contrôle par défaut qui provoque une publication.

<%@ 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 Page_Load(object sender, System.EventArgs e)
  {
    
    // Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to "
                + Form1.DefaultButton.ToString() + "<br/>";
    Label2.Text = "The DefaultFocus property is set to "
                + Form1.DefaultFocus.ToString();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </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 Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to " _
                  & Form1.DefaultButton.ToString & "<br/>"
    Label2.Text = "The DefaultFocus property is set to " _
                  & Form1.DefaultFocus.ToString
  End Sub
     
 </script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </form>

</body>

</html>

Remarques

La DefaultButton propriété vous permet de spécifier que les utilisateurs peuvent provoquer une publication en appuyant sur Entrée dans un contrôle d’entrée dans le formulaire (par exemple, une zone de texte). Vous pouvez spécifier comme bouton par défaut tout contrôle qui dérive de l’interface, à l’exception IButtonControl du LinkButton contrôle. Si le contrôle référencé par la DefaultButton propriété ne dérive pas de IButtonControl, une InvalidOperationException exception est levée.

Si vous utilisez des pages maîtres et que vous définissez la DefaultButton propriété à partir d’une page de contenu, utilisez la UniqueID propriété du IButtonControl bouton. Pour plus d’informations sur les pages maîtres, consultez pages maîtres ASP.NET.

La DefaultButton propriété peut ne pas provoquer de publication dans les scénarios suivants :

  • Appuyez sur ENTRÉE lorsque le focus est en dehors des contrôles d’entrée dans le formulaire. Le déclenchement de l’action de publication par défaut n’est pas garanti.

  • Appuyez sur ENTRÉE lorsque le focus est à l’intérieur d’une zone de texte multiligne. Dans une zone de texte multiligne, le comportement attendu est que le fait d’appuyer sur ENTRÉE crée une nouvelle ligne dans la zone de texte. Dans certains navigateurs, l’appui sur Entrée à l’intérieur d’une zone de texte multiligne déclenche une publication. Dans ce cas, si vous souhaitez qu’ENTRÉE crée une ligne à la place, vous pouvez attacher une fonction JavaScript au contrôle d’entrée. Le script doit capturer la clé ENTRÉE et arrêter la publication. Par exemple, vous pouvez utiliser la collection de Attributes propriétés pour ajouter un script client pour l’événement onKeyPress .

  • Spécification d’un LinkButton contrôle comme bouton par défaut. Seuls Button les contrôles et ImageButton sont pris en charge.

  • Modification de la DefaultButton propriété par programmation pendant une publication asynchrone. Les publications asynchrones peuvent être activées sur une page en ajoutant un ou plusieurs UpdatePanel contrôles à la page. Pour plus d’informations, consultez Vue d’ensemble du contrôle UpdatePanel et Vue d’ensemble du rendu de page partielle.

S’applique à

Voir aussi