Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

HtmlForm.DefaultButton-Eigenschaft

.NET Framework 4

Ruft das untergeordnete Steuerelement des HtmlForm-Steuerelements ab, das den Postback auslöst, wenn die EINGABETASTE gedrückt wird, oder legt dieses fest.

Namespace:  System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)
C#
C++
F#
VB
Kopieren 
public string DefaultButton { get; set; }
ASP.NET
Kopieren 
<asp:HtmlForm DefaultButton="String" />

Eigenschaftswert

Typ: System.String
Die ID des Button-Steuerelements, das als Standardschaltfläche angezeigt werden soll, wenn HtmlForm geladen wird. Der Standardwert ist eine leere Zeichenfolge ("").
Ausnahme Bedingung
InvalidOperationException

Das Steuerelement, auf das als Standardschaltfläche verwiesen wird, ist nicht vom Typ IButtonControl.

Mit der DefaultButton-Eigenschaft können Sie angeben, dass Benutzer durch Drücken der EINGABETASTE in einem Eingabesteuerelement des Formulars (z. B. einem Textfeld) einen Postback bewirken können. Als Standardschaltfläche können Sie mit Ausnahme des LinkButton-Steuerelements jedes Steuerelement angeben, das von der IButtonControl-Schnitstelle abgeleitet ist. Wenn das Steuerelement, auf das von der DefaultButton-Eigenschaft verwiesen wird, nicht von IButtonControl abgeleitet ist, wird eine InvalidOperationException-Ausnahme ausgelöst.

Wenn Sie Masterseiten verwenden und die DefaultButton-Eigenschaft aus einer Inhaltsseite festlegen, verwenden Sie die UniqueID-Eigenschaft der IButtonControl-Schaltfläche. Weitere Informationen zu Masterseiten finden Sie unter ASP.NET-Masterseiten.

Die DefaultButton-Eigenschaft bewirkt in den folgenden Szenarios möglicherweise kein Postback:

  • Das Drücken der EINGABETASTE, wenn sich der Fokus außerhalb der Eingabesteuerelemente im Formular befindet. Die Postback-Standardaktion wird nicht unbedingt ausgelöst.

  • Die EINGABETASTE wird gedrückt, während ein mehrzeiliges Textfeld den Fokus enthält. In einem mehrzeiligen Textfeld besteht das erwartete Verhalten darin, dass beim Drücken der EINGABETASTE eine neue Zeile im Textfeld erstellt wird. In einigen Browsern bewirkt das Drücken der EINGABETASTE in einem mehrzeiligen Textfeld ein Postback. Wenn in diesem Fall durch Drücken der EINGABETASTE eine neue Zeile erstellt werden soll, können Sie eine JavaScript-Funktion an das Eingabesteuerelement anfügen. Im Skript müssen die EINGABETASTE erfasst und der Postback beendet werden. Sie können beispielsweise mit der Attributes-Eigenschaftenauflistung Clientskripts für das onKeyPress-Ereignis hinzufügen.

  • Das Angeben eines LinkButton-Steuerelements als Standardschaltfläche. Es werden nur Button-Steuerelemente und ImageButton-Steuerelemente unterstützt.

  • Die DefaultButton-Eigenschaft wird während eines asynchronen Postbacks programmgesteuert geändert. Asynchrone Postbacks können auf einer Seite aktiviert werden, indem der Seite mindestens ein UpdatePanel-Steuerelement hinzugefügt wird. Weitere Informationen finden Sie unter Übersicht über das UpdatePanel-Steuerelement sowie unter Übersicht über das Teilrendering von Seiten.

Im folgenden Beispiel wird gezeigt, wie durch Festlegen der DefaultButton-Eigenschaft das Standardsteuerelement festgelegt wird, das Postbacks bewirkt.

C#
VB
Kopieren 

<%@ 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

Unterstützt in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ