Sintassi dichiarativa per il controllo server Web Button
Aggiornamento: novembre 2007
Visualizza un pulsante di comando nella pagina Web Form.
<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"
/>
Note
Il controllo Button consente di creare un pulsante di comando nella pagina Web Form. Due sono i tipi di pulsante che è possibile creare: un pulsante submit o un pulsante command.
Per impostazione predefinita, un controllo Button è un pulsante submit. A un pulsante submit non è associato un nome di comando, specificato dalla proprietà CommandName e si limita a restituire la pagina Web al server. È possibile mettere a disposizione dell'evento Click un gestore eventi, per controllare a livello di codice le azioni eseguite quando si fa clic sul pulsante submit.
A un pulsante command viene associato un nome di comando, ad esempio Sort, se viene impostata la proprietà CommandName. In tal modo è possibile creare più controlli Button in una pagina Web Form e stabilire a livello di codice su quale controllo Button viene fatto clic nel gestore eventi per l'evento Command. È inoltre possibile utilizzare la proprietà CommandArgument con un pulsante command per fornire ulteriori informazioni sul comando da eseguire, ad esempio Ascending. È possibile mettere a disposizione dell'evento Command un gestore eventi, per controllare a livello di codice le azioni eseguite quando si fa clic sul pulsante command.
I pulsanti Command vengono utilizzati spesso nei controlli con modelli per comunicare un'azione al controllo padre, ad esempio la selezione in un controllo DataList oppure la modalità di modifica in un controllo FormView.
Per impostazione predefinita, la convalida della pagina viene eseguita quando si fa clic su un controllo Button. La convalida della pagina consente di determinare se i controlli di input associati a un controllo di convalida nella pagina passano le regole di convalida specificate dal controllo di convalida stesso. Se è presente un controllo Button che disattiva questa funzionalità, ad esempio un pulsante reset, impostare la proprietà CausesValidation su false.
Nota
Poiché l'elemento <asp:Button> non ha contenuto, è possibile chiudere il tag con /> invece di utilizzare un tag di chiusura distinto.
Per specificare la didascalia visualizzata nel controllo Button, impostare la proprietà Text.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo Button, vedere la documentazione relativa a Button.
Esempio
Nell'esempio riportato di seguito viene illustrato come dichiarare un controllo pulsante submit in un file aspx.
<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"/>
Nell'esempio riportato di seguito viene illustrato come dichiarare un controllo pulsante command in un file aspx.
<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"/>
Nell'esempio riportato di seguito viene mostrato un metodo di gestione degli eventi in base al quale viene fatto clic sul pulsante e vengono visualizzate le informazioni passate dal pulsante alle rispettive proprietà CommandName e CommandArgument.
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.";
}