HtmlForm.DefaultButton Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Property DefaultButton As StringValeur de propriété
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
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, le fait d’appuyer sur Entrée dans 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.
