Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HtmlForm.DefaultButton propriété

 

Date de publication : novembre 2016

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

Espace de noms:   System.Web.UI.HtmlControls
Assembly:  System.Web (dans System.Web.dll)

public string DefaultButton { get; set; }

Valeur de propriété

Type: System.String

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

Exception Condition
InvalidOperationException

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

Le 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 un bouton par défaut de n’importe quel contrôle qui dérive de la IButtonControl à l’exception de l’interface du LinkButton contrôle. Si le contrôle qui est référencé par le DefaultButton propriété ne dérive pas de IButtonControl, un InvalidOperationException exception est levée.

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

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

  • En appuyant sur ENTRÉE lorsque le focus est en dehors des contrôles d’entrée dans le formulaire. L’action de publication par défaut n’est pas garantie être déclenché.

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

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

  • Modification de la DefaultButton propriété par programme lors d’une publication (postback) asynchrone. Publications asynchrones peuvent être activées sur une page en ajoutant un ou plusieurs UpdatePanel contrôles à la page. Pour plus d’informations, consultez UpdatePanel Control Overview et Partial-Page Rendering Overview.

L’exemple suivant montre comment définir le 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>

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: