Deklarative Syntax des Button-Webserversteuerelements
Aktualisiert: November 2007
Zeigt ein Schaltflächensteuerelement auf einer Web Forms-Seite an.
<asp:Button
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnClick="Click event handler"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
UseSubmitBehavior="True|False"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mit dem Button-Steuerelement können Sie eine Schaltfläche auf einer Web Forms-Seite erstellen. Es gibt zwei Arten von Schaltflächen, die erstellt werden können: eine submit-Schaltfläche und eine command-Schaltfläche.
Standardmäßig handelt es sich bei Button-Steuerelementen um submit-Steuerelemente. Mit einer submit-Schaltfläche ist kein Befehlsname (angegeben durch die CommandName-Eigenschaft) verknüpft, und die Schaltfläche sendet die Webseite lediglich zurück an den Server. Sie können einen Ereignishandler für das Click-Ereignis bereitstellen, um die Aktionen, die beim Klicken auf die submit-Schaltfläche ausgeführt werden, programmgesteuert zu steuern.
Eine command-Schaltfläche verfügt über einen mit ihr verknüpften Befehlsnamen (z. B. Sort), der in der CommandName-Eigenschaft angegeben ist. Dadurch können Sie auf einer Web Forms-Seite mehrere Button-Steuerelemente erstellen und im Ereignishandler für das Command-Ereignis programmgesteuert bestimmen, auf welches Button-Steuerelement geklickt wurde. Sie können auch die CommandArgument-Eigenschaft mit einer command-Schaltfläche verwenden, um zusätzliche Informationen zu dem auszuführenden Befehl anzugeben, z. B. Ascending. 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.
Command-Schaltflächen werden häufig in vorlagenbasierten Steuerelementen verwendet, um das übergeordnete Steuerelement über eine Aktion zu informieren, z. B. über eine Auswahl in einer DataList oder das Ändern des Modus eines FormView.
Standardmäßig wird beim Klicken auf ein Button-Steuerelement eine Seitenvalidierung durchgeführt. Bei der Seitenvalidierung wird festgestellt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind. Wenn dieses Verhalten für ein Button-Steuerelement deaktiviert werden muss, z. B. für eine reset-Schaltfläche, legen Sie die CausesValidation-Eigenschaft auf false fest.
Tipp
Da das <asp:Button>-Element über keinerlei Inhalt verfügt, können Sie das Tag mit /> anstatt mit einem separaten Endtag schließen.
Um die Beschriftung anzugeben, die für das Button-Steuerelement angezeigt wird, legen Sie die Text-Eigenschaft fest.
Ausführliche Informationen zu den Eigenschaften und Ereignissen des Button-Steuerelements finden Sie in der Dokumentation zu Button.
Beispiel
Das folgende Beispiel veranschaulicht die Deklaration eines submit-Schaltflächensteuerelements in einer ASPX-Datei.
<asp:Button id="SubmitButton"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server" />
<asp:Button id="SubmitButton"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
Das folgende Beispiel veranschaulicht die Deklaration eines command-Schaltflächensteuerelements in einer ASPX-Datei.
<asp:Button id="SortAscendingButton"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<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 der CommandName-Eigenschaft und der CommandArgument-Eigenschaft übergeben werden.
Sub CommandBtn_Click(ByVal sender As Object, ByVal e As CommandEventArgs)
Message.Text = "You clicked the " & e.CommandName & _
" - " & e.CommandArgument & " button."
End Sub
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
Message.Text = "You clicked the " + e.CommandName +
" - " + e.CommandArgument + " button.";
}