Panel.DefaultButton Eigenschaft

Definition

Ruft den Bezeichner für die Standardschaltfläche ab, die im Panel-Steuerelement enthalten ist, oder legt diesen fest.Gets or sets the identifier for the default button that is contained in the Panel control.

public:
 virtual property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DefaultButton { get; set; }
member this.DefaultButton : string with get, set
Public Overridable Property DefaultButton As String

Eigenschaftswert

Ein Zeichenfolgenwert, der der ID für ein im Panel enthaltenes Schaltflächensteuerelement entspricht.A string value corresponding to the ID for a button control contained in the Panel. Der Standardwert ist eine leere Zeichenfolge und gibt an, dass Panel keine Standardschaltfläche besitzt.The default is an empty string, indicating that the Panel does not have a default button.

Attribute

Hinweise

Verwenden Sie die DefaultButton-Eigenschaft, um anzugeben, auf welche Schaltfläche geklickt wird, wenn das Panel Steuerelement den Fokus besitzt und der Benutzer die EINGABETASTE drückt.Use the DefaultButton property to indicate which button gets clicked when the Panel control has focus and the user presses the ENTER key. Der DefaultButton kann auf den Bezeichner für ein Button Steuerelement oder ein beliebiges Steuerelement festgelegt werden, das die IButtonControl-Schnittstelle außer einem LinkButton Steuerelement implementiertThe DefaultButton can be set to the identifier for a Button control or any control that implements the IButtonControl interface except a LinkButton control.

Wenn die DefaultButton auf ein Steuerelement festgelegt ist, das die IButtonControl-Schnittstelle nicht implementiert, oder auf ein Steuerelement, das nicht im Panel-Steuerelement enthalten ist, löst das Panel Steuerelement beim Rendern eine Ausnahme aus.If the DefaultButton is set to a control that does not implement the IButtonControl interface, or to a control that is not contained in the Panel control, the Panel control throws an exception while rendering.

Das Festlegen der DefaultButton-Eigenschaft wird für die folgenden Szenarien nicht unterstützt:Setting the DefaultButton property is not supported for the following scenarios:

  • Festlegen des Fokus außerhalb der Eingabe Steuerelemente im Panel und drücken der EINGABETASTE.Setting focus outside of the input controls in the panel and then pressing the ENTER key. Die Standardaktion für das Postback ist nicht garantiert.The default post back action is not guaranteed to trigger.

  • Drücken der EINGABETASTE mit Fokus in einem mehrzeiligen Textfeld.Pressing the ENTER key with focus inside a multi-line textbox. In einem mehrzeiligen Textfeld sollte durch Drücken der EINGABETASTE im Textfeld eine neue Zeile erstellt werden. Dies ist das erwartete Verhalten.In a multi-line textbox, pressing the ENTER key should create a new line in the textbox which is the expected behavior. In Browsern, in denen das Drücken der EINGABETASTE in einem mehrzeiligen Textfeld ein Postback auslöst, aber Sie möchten, dass die EINGABETASTE eine neue Zeile erstellt, können Sie eine JavaScript-Funktion an das Eingabe Steuerelement anfügen.In browsers where the pressing the ENTER key inside a multi-line textbox triggers a post back but you want the ENTER key to create a new line instead you can attach a JavaScript function to the input control. Das Skript sollte die EINGABETASTE erfassen und den Postback abbrechen.The script should capture the ENTER key and stop the post back. Beispielsweise können Sie mit der Attributes-Eigenschaften Auflistung das Client Skript für das onKeyPress-Ereignis hinzufügen.For example, you can use the Attributes property collection to add client script for the onKeyPress event.

  • Verweisen auf eine Standard Schaltfläche, die ein LinkButton Steuerelement ist.Referencing a default button that is a LinkButton control. Nur Button-und ImageButton-Steuerelemente werden unterstützt.Only Button and ImageButton controls are supported.

  • Programm gesteuertes Ändern der DefaultButton während eines asynchronen Postbacks, wenn sich das Panel-Steuerelement nicht in einem UpdatePanel-Steuerelement befindet.Changing the DefaultButton programmatically during an asynchronous post back when the Panel control is not inside of an UpdatePanel control. Asynchrone Postbacks können auf einer Seite aktiviert werden, indem der Seite ein oder mehrere UpdatePanel-Steuerelemente hinzugefügt werden.Asynchronous post backs can be enabled on a page by adding one or more UpdatePanel controls to the page. UpdatePanel Steuerelemente können verwendet werden, um ausgewählte Bereiche einer Seite zu aktualisieren, anstatt die gesamte Seite mit einem Postback zu aktualisieren.UpdatePanel controls can be used to update selected regions of a page instead of updating the whole page with a postback. Weitere Informationen finden Sie unter Übersicht über das Update Panel-Steuer Element und Übersicht über das Seiten Rendering.For more information, see UpdatePanel Control Overview and Partial-Page Rendering Overview.

  • Diese Eigenschaft wird anhand von Designs oder Stylesheet-Designs festgelegt.Setting this property by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch