Panel.DefaultButton Eigenschaft

  • Referenz

Definition

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

Ruft den Bezeichner für die Standardschaltfläche ab, die im Panel-Steuerelement enthalten ist, oder legt diesen fest.

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; }
[<System.Web.UI.Themeable(false)>]
member this.DefaultButton : string with get, set
Public Overridable Property DefaultButton As String

Eigenschaftswert

String

Ein Zeichenfolgenwert, der der ID für ein im Panel enthaltenes Schaltflächensteuerelement entspricht. Der Standardwert ist eine leere Zeichenfolge und gibt an, dass Panel keine Standardschaltfläche besitzt.

Attribute
ThemeableAttribute

Hinweise

Verwenden Sie die DefaultButton -Eigenschaft, um anzugeben, auf welche Schaltfläche geklickt wird, wenn das Panel Steuerelement den Fokus hat und der Benutzer die EINGABETASTE drückt. Kann DefaultButton auf den Bezeichner für ein Steuerelement oder ein Button beliebiges Steuerelement festgelegt werden, das die IButtonControl Schnittstelle mit Ausnahme eines LinkButton Steuerelements implementiert.

Wenn auf DefaultButton 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.

Das Festlegen der DefaultButton Eigenschaft wird für die folgenden Szenarien nicht unterstützt:

  • Legen Sie den Fokus außerhalb der Eingabesteuerelemente im Bereich fest, und drücken Sie dann die EINGABETASTE. Die Standardmäßige Postback-Aktion wird nicht garantiert ausgelöst.

  • Drücken der EINGABETASTE mit Fokus in einem mehrzeiligen Textfeld. In einem mehrzeiligen Textfeld sollte durch Drücken der EINGABETASTE eine neue Zeile im Textfeld erstellt werden, was dem erwarteten Verhalten entspricht. In Browsern, in denen das Drücken der EINGABETASTE in einem mehrzeiligen Textfeld einen Beitrag zurück auslöst, Sie aber möchten, dass die EINGABETASTE eine neue Zeile erstellt, können Sie stattdessen eine JavaScript-Funktion an das Eingabesteuerelement anfügen. Das Skript sollte die EINGABETASTE erfassen und den Postback beenden. Beispielsweise können Sie die Attributes Eigenschaftensammlung verwenden, um clientskripts für das onKeyPress Ereignis hinzuzufügen.

  • Verweisen auf eine Standardschaltfläche, bei der es sich um ein LinkButton Steuerelement handelt. Nur Button Und-Steuerelemente ImageButton werden unterstützt.

  • DefaultButton Programmgesteuertes Ändern während eines asynchronen Postbacks, wenn sich das Panel Steuerelement nicht in einem UpdatePanel Steuerelement befindet. Asynchrone Postbacks können auf einer Seite aktiviert werden, indem der Seite ein oder mehrere UpdatePanel Steuerelemente hinzugefügt werden. UpdatePanel Steuerelemente können verwendet werden, um ausgewählte Regionen einer Seite zu aktualisieren, anstatt die gesamte Seite mit einem Postback zu aktualisieren. Weitere Informationen finden Sie unter Übersicht über das UpdatePanel-Steuerelement und Übersicht über das Partielle Rendern von Seiten.

  • Festlegen dieser Eigenschaft nach Designs oder Stylesheetdesigns. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.

Gilt für:

Weitere Informationen