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 HtmlForm contrôle 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é
Contrôle ID bouton à afficher comme bouton par défaut lors du HtmlForm chargement. 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 différée.
<%@ 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 en tant que bouton par défaut n’importe quel contrôle dérivé 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 IButtonControlpas , 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 ASP.NET Pages maîtres.
La DefaultButton propriété peut ne pas entraîner de publication dans les scénarios suivants :
Appuyez sur ENTRÉE lorsque le focus se trouve en dehors des contrôles d’entrée dans le formulaire. L’action de publication par défaut n’est pas garantie d’être déclenchée.
Appuyez sur Entrée lorsque le focus se trouve à l’intérieur d’une zone de texte à plusieurs lignes. Dans une zone de texte à plusieurs lignes, le comportement attendu est que l’appui sur ENTRÉE crée une ligne dans la zone de texte. Dans certains navigateurs, l’appui sur Entrée à l’intérieur d’une zone de texte à plusieurs lignes déclenche une publication différée. 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 propriétés pour ajouter un Attributes script client pour l’événement
onKeyPress.Spécification d’un LinkButton contrôle en tant que bouton par défaut. Seuls Button et ImageButton les contrôles sont pris en charge.
Modification de la DefaultButton propriété par programmation pendant une publication asynchrone. Les postbacks asynchrones peuvent être activés 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.
