HtmlForm.DefaultButton Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

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

public:
 property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
public string DefaultButton { get; set; }
member this.DefaultButton : string with get, set
Public Property DefaultButton As String

Eigenschaftswert

String

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

Ausnahmen

InvalidOperationException

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

Beispiele

Das folgende Beispiel zeigt, wie die DefaultButton -Eigenschaft festgelegt wird, um das Standardsteuerelement festzulegen, das ein 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 DefaultButton der -Eigenschaft können Sie angeben, dass Benutzer ein Postback verursachen können, indem sie die EINGABETASTE in einem Eingabesteuerelement im Formular (z. B. ein Textfeld) drücken. Sie können als Standardschaltfläche jedes Steuerelement angeben, das von der IButtonControl Schnittstelle mit Ausnahme des LinkButton -Steuerelements abgeleitet ist. Wenn das Steuerelement, auf das von der DefaultButton -Eigenschaft verwiesen wird, nicht von IButtonControlabgeleitet wird, wird eine InvalidOperationException Ausnahme ausgelöst.

Wenn Sie Gestaltungsvorlagen verwenden und die DefaultButton -Eigenschaft auf 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 verursacht in den folgenden Szenarien möglicherweise kein Postback:

  • 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 sie die EINGABETASTE, wenn sich der Fokus in einem mehrzeiligen Textfeld befindet. In einem mehrzeiligen Textfeld wird erwartet, dass durch drücken der EINGABETASTE eine neue Zeile im Textfeld erstellt wird. In einigen Browsern wird durch Drücken der EINGABETASTE in einem mehrzeiligen Textfeld ein Postback ausgelöst. Wenn Sie in diesem Fall stattdessen eine neue Zeile erstellen möchten, können Sie eine JavaScript-Funktion an das Eingabesteuerelement anfügen. Das Skript sollte die EINGABETASTE erfassen und das Postback beenden. Sie können beispielsweise die Attributes Eigenschaftensammlung verwenden, um clientskripts für das onKeyPress Ereignis hinzuzufügen.

  • Angeben eines LinkButton Steuerelements als Standardschaltfläche. Nur Button Steuerelemente und ImageButton werden unterstützt.

  • Programmgesteuertes Ändern der DefaultButton Eigenschaft während eines asynchronen Postbacks. Asynchrone Postbacks können auf einer Seite aktiviert werden, indem der Seite ein oder UpdatePanel mehrere Steuerelemente hinzugefügt werden. Weitere Informationen finden Sie unter Übersicht über das UpdatePanel-Steuerelement und Übersicht über teilseitiges Rendern.

Gilt für:

Weitere Informationen