Übersicht über die Button-Webserversteuerelemente

Artikel
10/22/2014

Aktualisiert: November 2007

Verwenden Sie die ASP.NET-Button-Webserversteuerelemente, um den Benutzern die Möglichkeit zu geben, eine Seite an den Server zu senden und ein Ereignis auf einer Seite auszulösen.

Dieses Thema enthält folgende Abschnitte:

Hintergrund
Codebeispiele
Klassenreferenz

Hintergrund

Mit dem Button-Webserversteuerelement geben Sie Benutzern die Möglichkeit, eine Seite an den Server zu senden. Das Steuerelement löst im Servercode ein Ereignis aus, das Sie behandeln können, um auf das Postback zu reagieren. Ein Benutzer kann z. B. angeben, dass ein Formular ausgefüllt wurde oder dass ein bestimmter Befehl ausgeführt werden soll.

ASP.NET enthält drei Arten von Button-Steuerelementen, die auf Webseiten jeweils unterschiedlich dargestellt werden. Sie sind in der folgenden Tabelle aufgeführt:

Steuerelement	Beschreibung
Button	Zeigt eine Standardbefehlsschaltfläche an, die als HTML-input-Element dargestellt wird.
LinkButton	Wird auf der Seite als Hyperlink ausgegeben. Enthält jedoch clientseitiges Skript, wodurch das Formular zurück zum Server übermittelt wird. (Sie können einen echten Hyperlink erstellen, indem Sie das HyperLink-Webserversteuerelement verwenden.)
ImageButton	Rendert eine Grafik als Schaltfläche. Dies ist nützlich für das Darstellen von Schaltflächen mit vielfältigem Aussehen. Das ImageButton-Steuerelement stellt auch Informationen darüber bereit, auf welche Koordinaten innerhalb der Grafik geklickt wurde.

Sie können auch das HtmlButton-Steuerelement und dasHtmlInputButton-Steuerelement verwenden, um auf der Seite Schaltflächen zu erstellen, die in Servercode programmierbar sind. Einzelheiten über die Unterschiede zwischen HTML- und Webserversteuerelementen finden Sie unter Übersicht über ASP.NET-Webserversteuerelemente.

Mithilfe des ImageMap-Steuerelements können Sie eine Grafik mit Hotspots erstellen, auf die die Benutzer klicken können, um ein Postback oder eine andere Aktion auszuführen.

Schaltflächenereignisse

Wenn ein Benutzer auf ein Button-Webserversteuerelement klickt, wird die Seite an den Server gesendet. Das hat zur Folge, dass die Webseite verarbeitet wird und alle ausstehenden Ereignisse im serverbasierten Code ausgelöst werden. Von Schaltflächen können auch eigene Click-Ereignisse ausgelöst werden, für die Sie Ereignishandler schreiben können.

Button-Steuerelemente und Validierung

Wenn eine Seite ASP.NET-Validierungssteuerelemente enthält, führen Mausklicks auf ein Button-Steuerelement standardmäßig zur einer Prüfung durch das Validierungssteuerelement. Wenn für ein Validierungssteuerelement die clientseitige Validierung aktiviert ist, wird die Seite bei einer fehlgeschlagenen Validierung nicht übertragen.

Die folgende Tabelle beschreibt die von den Button-Steuerelementen bereitgestellten Eigenschaften zur detaillierten Steuerung des Validierungsprozesses.

Eigenschaft	Beschreibung
CausesValidation	Gibt an, ob beim Klicken auf eine Schaltfläche auch eine Validierung durchgeführt wird. Legen Sie diese Eigenschaft auf false fest, um eine Validierung zu verhindern.
ValidationGroup	Gibt an, welche Validierungssteuerelemente der Seite beim Klicken auf die Schaltfläche aufgerufen werden. Wenn keine Validierungsgruppen angelegt sind, werden alle Validierungssteuerelemente der Seite aufgerufen.

Weitere Informationen finden Sie unter Überprüfen der Benutzereingabe in ASP.NET-Webseiten.

Postbackverhalten von Schaltflächen

Wenn der Benutzer auf ein Button-Steuerelement klickt, wird die Seite an den Server zurückgesendet. Standardmäßig wird die Seite an sich selbst zurückgesendet. Dort wird die Seite neu generiert, und die Ereignishandler für die Steuerelemente auf der Seite werden verarbeitet.

Sie können Schaltflächen so konfigurieren, dass die aktuelle Seite an eine andere Seite gesendet wird. Dies kann nützlich sein, um mehrseitige Formulare zu erstellen. Ausführliche Informationen finden Sie unter Seitenübergreifendes Senden in ASP.NET-Webseiten.

Standardmäßig übermittelt das Button-Steuerelement die Seite durch eine HTML-POST-Operation. Das LinkButton-Steuerelement und das ImageButton-Steuerelement bieten keine direkte Unterstützung für die HTML-POST-Operation. Wenn Sie diese Schaltflächen verwenden, wird der Seite deshalb ein Clientskript hinzugefügt, mit dem die Steuerelemente die Seite programmgesteuert übermitteln können. (Für das LinkButton-Steuerelement und das ImageButton-Steuerelement müssen Clientskripts auf dem Browser aktiviert sein.)

In bestimmten Situationen kann es sinnvoll sein, dass auch das Button-Steuerelement das Postback über ein Clientskript durchführt. Das kann nützlich sein, wenn Sie den Postbackvorgang programmgesteuert ändern möchten, um beispielsweise andere Elemente der Seite damit zu verknüpfen. Sie können die UseSubmitBehavior-Eigenschaft des Button-Steuerelements auf true festlegen, damit das Button-Steuerelement Clientskript für das Postback verwendet.

Verwenden von Schaltflächen mit UpdatePanel-Steuerelementen

Das Teilrendering von Seiten ermöglicht die Aktualisierung von Teilen einer Seite ohne Postback. Mithilfe von UpdatePanel-Steuerelementen können Sie die Teile der Seite markieren, die am Teilrendering von Seiten teilnehmen. Das Standardverhalten von Steuerelementen innerhalb eines UpdatePanel-Steuerelements, einschließlich Button-Steuerelementen, ist ein asynchrones Postback anstelle eines Postbacks. Damit wird nur der Inhalt des UpdatePanel-Steuerelements aktualisiert, von dem das Postback stammt.

Neben einem Button-Steuerelement innerhalb eines UpdatePanel-Steuerelements können Sie auch in den folgenden Szenarien Button-Steuerelemente mit UpdatePanel-Steuerelementen verwenden:

Definieren eines Button-Steuerelements, das sich außerhalb eines UpdatePanel-Steuerelements als AsyncPostBackTrigger-Steuerelement für diesen Bereich befindet. Beim Klicken auf die Schaltfläche wird ein asynchrones Postback ausgeführt, und der Inhalt des Bereichs wird aktualisiert.
Definieren eines Button-Steuerelements, das sich innerhalb eines UpdatePanel-Steuerelements als PostBackTrigger-Steuerelement für den Bereich befindet. Beim Klicken auf die Schaltfläche wird ein Postback ausgeführt, obwohl sie sich innerhalb eines UpdatePanel-Steuerelements befindet.

Weitere Informationen zum Teilrendering von Seiten und zur Verwendung von UpdatePanel-Steuerelementen finden Sie unter Übersicht über das UpdatePanel-Steuerelement und Übersicht über das Teilrendering von Seiten.

Behandeln von clientseitigen Ereignissen für Button-Steuerelemente

Button-Steuerelemente können sowohl Serverereignisse als auch Clientereignisse auslösen. Serverereignisse treten nach dem Postback auf und werden vom serverseitigen Code der Seite behandelt. Clientereignisse werden im Clientskript behandelt, das üblicherweise in ECMAScript (JavaScript) verfasst ist. Clientereignisse treten auf, bevor die Seite übermittelt wird. Indem Sie ASP.NET-Button-Steuerelementen clientseitige Ereignisse hinzufügen, können Sie z. B. vor dem Übermitteln einer Seite ein Bestätigungsdialogfeld anzeigen, mit dem der Benutzer die Übermittlung abbrechen kann. Detaillierte Informationen zu diesem Thema finden Sie unter Clientskript in ASP.NET-Webseiten und Gewusst wie: Reagieren auf Ereignisse in Button-Webserversteuerelementen in Clientskript.

Schaltflächen in Datensteuerelementen

Button-Webserversteuerelemente werden häufig in Datensteuerelementen verwendet, so z. B. im DataList-Listensteuerelement, im GridView-Listensteuerelement und im Repeater-Listensteuerelement. In diesen Fällen reagieren Sie in der Regel nicht direkt auf das Click-Ereignis für eine Schaltfläche. Stattdessen löst eine Schaltfläche in einem Datensteuerelement ein für das Datensteuerelement spezifisches Ereignis aus. Es kann z. B. vorkommen, dass eine Schaltfläche im DataList-Steuerelement anstelle des Click-Ereignisses des Button-Steuerelements das ItemCommand-Ereignis des DataList-Steuerelements auslöst.

Da datengebundene Listensteuerelemente unter Umständen viele Schaltflächen enthalten, können Sie mit der CommandArgument-Eigenschaft der Schaltfläche festlegen, welcher Wert bei einem Ereignis übergeben wird. Durch Überprüfung dieses Arguments kann anschließend ermittelt werden, auf welche Schaltfläche geklickt worden ist.

Binden von Daten an Steuerelemente

Sie können Button-Webserversteuerelemente an Datenquellen binden, um ihre Eigenschafteneinstellungen dynamisch zu steuern. So lässt sich z. B. die Text-Eigenschaft einer Schaltfläche durch Datenbindung festlegen.