Controllo server Web Button
Visualizza un pulsante di comando nella pagina Web Form.
<asp:Button id="MyButton"
Text="label"
CommandName="command"
CommandArgument="commandargument"
CausesValidation="true | false"
OnClick="OnClickMethod"
runat="server"/>
Osservazioni
Il controllo Button consente di creare un pulsante di comando nella pagina Web Form. Il controllo può creare due tipi di pulsante: un pulsante submit oppure un pulsante command.
Per impostazione predefinita, un controllo Button è un pulsante submit. Un pulsante submit non ha un nome di comando associato, 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.
Un pulsante command ha un nome di comando associato, 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 creare un gestore eventi per l'evento Command, per controllare a livello di codice le azioni eseguite quando si fa clic sul pulsante command.
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 per la disattivazione di questa funzionalità, ad esempio un pulsante di reimpostazione, 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 server Web Button, vedere la documentazione di Classe Button.
Esempio
Nell'esempio seguente viene mostrato come dichiarare un controllo pulsante submit in un file aspx.
<asp:Button id="SubmitButton"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
Nell'esempio seguente viene mostrato 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"/>
Nell'esempio seguente viene mostrato un metodo di gestione dell'evento in base al quale viene fatto clic sul pulsante e vengono visualizzate le informazioni passate dal pulsante alle sue proprietà CommandName e CommandArgument.
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.";
}