HtmlForm.DefaultButton Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ab oder legt das untergeordnete Steuerelement des HtmlForm Steuerelements, das postback verursacht, wenn die EINGABETASTE gedrückt wird.
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 StringEigenschaftswert
Das ID Schaltflächensteuerelement, das beim HtmlForm Laden als Standardschaltfläche angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge ("").
Ausnahmen
Das Steuerelement, auf das als Standardschaltfläche verwiesen wird, ist nicht vom Typ IButtonControl.
Beispiele
Das folgende Beispiel zeigt, wie die DefaultButton Eigenschaft so festgelegt wird, dass das Standardsteuerelement festgelegt wird, das einen Postback verursacht.
<%@ 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>
Hinweise
Mit der DefaultButton Eigenschaft können Sie angeben, dass Benutzer einen Postback verursachen können, indem Sie die EINGABETASTE in einem Eingabesteuerelement im Formular drücken (z. B. ein Textfeld). Sie können ein beliebiges Steuerelement, das von der IButtonControl Schnittstelle abgeleitet wird, mit Ausnahme des LinkButton Steuerelements als Standardschaltfläche angeben. Wenn das Steuerelement, auf das von der DefaultButton Eigenschaft verwiesen wird, nicht abgeleitet IButtonControlwird, wird eine InvalidOperationException Ausnahme ausgelöst.
Wenn Sie Gestaltungsvorlagen verwenden und die DefaultButton Eigenschaft von einer Inhaltsseite festlegen, verwenden Sie die UniqueID Eigenschaft der IButtonControl Schaltfläche. Weitere Informationen zu Gestaltungsvorlagen finden Sie unter ASP.NET Gestaltungsvorlagen.
Die DefaultButton Eigenschaft kann in den folgenden Szenarien keinen Postback verursachen:
Drücken der EINGABETASTE, wenn sich der Fokus außerhalb der Eingabesteuerelemente im Formular befindet. Die standardmäßige Postbackaktion wird nicht garantiert ausgelöst.
Drücken der EINGABETASTE, wenn sich der Fokus in einem mehrzeiligen Textfeld befindet. In einem mehrzeiligen Textfeld erstellt das erwartete Verhalten, dass durch Drücken der EINGABETASTE eine neue Zeile im Textfeld erstellt wird. In einigen Browsern löst das Drücken der EINGABETASTE in einem mehrzeiligen Textfeld einen Postback aus. Wenn Sie stattdessen eine neue Zeile erstellen möchten, können Sie dem Eingabesteuerelement eine JavaScript-Funktion anfügen. Das Skript sollte die EINGABETASTE erfassen und den Postback beenden. Sie können z. B. die Attributes Eigenschaftsauflistung verwenden, um clientskript für das
onKeyPressEreignis hinzuzufügen.Angeben eines Steuerelements LinkButton als Standardschaltfläche. Nur Button und ImageButton Steuerelemente werden unterstützt.
Programmgesteuertes Ändern der DefaultButton Eigenschaft während eines asynchronen Postbacks. Asynchrone Postbacks können auf einer Seite aktiviert werden, indem sie der Seite ein oder UpdatePanel mehrere Steuerelemente hinzufügen. Weitere Informationen finden Sie unter UpdatePanel Control Overview and Partial-Page Rendering Overview.
