Button-Webserversteuerelement
Zeigt ein Schaltflächensteuerelement auf einer Web Forms-Seite an.
<asp:Button id="MyButton"
Text="label"
CommandName="command"
CommandArgument="commandargument"
CausesValidation="true | false"
OnClick="OnClickMethod"
runat="server"/>
Hinweise
Mit dem Button-Steuerelement können Sie eine Schaltfläche auf einer Web Forms-Seite erstellen. Zwei Arten von Schaltflächen können erstellt werden: submit-Schaltflächen oder command-Schaltflächen.
Standardmäßig ist ein Button-Steuerelement eine submit-Schaltfläche. Mit einer submit-Schaltfläche ist kein Befehlsname (angegeben durch die CommandName-Eigenschaft) verknüpft, und die Schaltfläche sendet lediglich die Webseite zurück an den Server. Sie können einen Ereignishandler für das Click-Ereignis bereitstellen, um die beim Klicken auf die submit-Schaltfläche ausgeführten Aktionen programmgesteuert zu steuern.
Mit einer command-Schaltfläche ist durch Setzen der CommandName-Eigenschaft ein Befehlsname verknüpft (z. B. Sortieren). Dadurch können Sie auf einer Web Forms-Seite mehrere Button-Steuerelemente erstellen und programmgesteuert bestimmen, auf welches Button-Steuerelement im Ereignishandler für das Command-Ereignis geklickt wird. Sie können auch die CommandArgument-Eigenschaft für eine command-Schaltfläche verwenden, um zusätzliche Informationen zu dem auszuführenden Befehl bereitzustellen, z. B. Aufsteigend. Sie können einen Ereignishandler für das Command-Ereignis bereitstellen, um die Aktionen, die beim Klicken auf die command-Schaltfläche ausgeführt werden, programmgesteuert zu steuern.
Standardmäßig wird beim Klicken auf ein Button-Steuerelement eine Seitenüberprüfung durchgeführt. Bei der Seitenüberprüfung wird festgestellt, ob die einem Steuerelement für die Gültigkeitsprüfung auf der Seite zugeordneten Eingabesteuerelemente allen Überprüfungsregeln entsprechen, die durch das Steuerelement für die Gültigkeitsprüfung festgelegt sind. Wenn Sie ein Button-Steuerelement verwenden, für das dieses Verhalten deaktiviert werden muss, z. B. eine Schaltfläche Zurücksetzen, setzen Sie die CausesValidation-Eigenschaft auf false.
Hinweis Da das <asp:Button>-Element keinen Inhalt hat, können Sie das Tag mit /> abschließen, anstatt ein separates schließendes Tag zu verwenden.
Um die Beschriftung anzugeben, die auf dem Button-Steuerelement angezeigt wird, setzen Sie die Text-Eigenschaft.
Weitere Informationen zu den Eigenschaften und Ereignissen des Button-Steuerelements finden Sie unter Button-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie ein submit-Schaltflächensteuerelement in einer ASPX-Datei deklariert wird.
<asp:Button id="SubmitButton"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
Das folgende Beispiel veranschaulicht, wie ein command-Schaltflächensteuerelement in einer ASPX-Datei deklariert wird.
<asp:Button id="SortAscendingButton"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
Das folgende Beispiel veranschaulicht eine Ereignisbehandlungsmethode, bei der der Klick auf die Schaltfläche abgerufen wird und die Informationen angezeigt werden, die von der Schaltfläche in den Eigenschaften CommandName und CommandArgument übergeben werden.
Sub CommandBtn_Click(sender As Object, e As CommandEventArgs)
Message.Text = "You clicked the " & e.CommandName & _
" - " & e.CommandArgument & " button."
End Sub
[C#]
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
Message.Text = "You clicked the " + e.CommandName +
" - " + e.CommandArgument + " button.";
}