Syntaxe déclarative du contrôle serveur Web Button

Mise à jour : novembre 2007

Affiche un contrôle bouton de commande sur la page Web Forms.

<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"
/>

Notes

Le contrôle Button permet de créer un bouton de commande sur la page Web Forms. Il est possible de créer deux types de boutons : un bouton submit ou un bouton command.

Par défaut, un contrôle Button est un bouton submit. Un bouton submit n'a pas de nom de commande (spécifié par la propriété CommandName) associé au bouton et republie simplement la page Web sur le serveur. Vous pouvez fournir un gestionnaire d'événements pour l'événement Click afin de contrôler par programme les actions exécutées suite à un clic sur le bouton submit.

Un bouton command possède un nom de commande associé au bouton (par exemple, Sort) en définissant la propriété CommandName. Vous pouvez ainsi créer plusieurs contrôles Button sur une page Web Forms et déterminer par programme sur quel contrôle Button il faut cliquer dans le gestionnaire d'événements de l'événement Command. Vous pouvez également utiliser la propriété CommandArgument avec un bouton command pour fournir des informations supplémentaires, telles que Ascending sur la commande à effectuer. Vous pouvez fournir un gestionnaire d'événements pour l'événement Command afin de contrôler par programme les actions exécutées suite à un clic sur le bouton command.

Les boutons Command sont souvent utilisés dans des contrôles basés sur des modèles pour communiquer une action au contrôle parent, par exemple, une sélection dans un contrôle DataList ou la modification du mode dans un contrôle FormView.

Par défaut, une validation de page est effectuée suite à un clic sur le contrôle Button. La validation de la page détermine si les contrôles d'entrée associés à un contrôle de validation passent avec succès les règles de validation spécifiées par le contrôle de validation. Si vous possédez un contrôle Button qui doit désactiver ce comportement, par exemple un bouton reset, affectez à la propriété CausesValidation la valeur false.

Remarque :
Dans la mesure où l'élément <asp:Button> n'a pas de contenu, vous pouvez fermer la balise avec /> au lieu d'une balise de fermeture distincte.

Pour spécifier la légende affichée dans le contrôle Button, définissez la propriété Text.

Pour plus d'informations sur les propriétés et événements du contrôle Button, consultez la documentation de Button.

Exemple

L'exemple suivant illustre la déclaration d'un contrôle de type bouton submit dans un fichier .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"/>

L'exemple suivant illustre la déclaration d'un contrôle de type bouton command dans un fichier .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"/>

L'exemple suivant illustre une méthode de gestion d'événements qui obtient le clic sur le bouton et affiche les informations transmises à partir du bouton dans ses propriétés CommandName et 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.";
}

Voir aussi

Référence

Button

Autres ressources

Syntaxe des contrôles serveur Web