Partager via

Syntaxe déclarative du contrôle serveur Web LinkButton

  • Article

Mise à jour : novembre 2007

Crée un bouton de style lien hypertexte sur une page Web Forms.

<asp:LinkButton
    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"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Notes

Utilisez le contrôle LinkButton pour créer un bouton de style lien hypertexte sur une page Web Forms. Spécifiez le texte à afficher dans le contrôle LinkButton soit en définissant la propriété Text, soit en plaçant le texte entre les balises d'ouverture et de fermeture du contrôle LinkButton. Vous pouvez créer un bouton de type "Submit" ou un bouton de commande.

Remarque :

Le contrôle LinkButton a la même apparence qu'un contrôle HyperLink, mais la même fonctionnalité qu'un contrôle Button. Utilisez le contrôle HyperLink si vous voulez créer un lien vers une autre page Web après un clic sur le contrôle.

Un bouton submit n'a pas de nom de commande associé et publie simplement la page Web sur le serveur. Par défaut, un contrôle LinkButton est un bouton submit. 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.

En définissant la propriété CommandName, vous pouvez associer un nom de commande au bouton de commande, Sort par exemple. Cela vous permet de créer plusieurs contrôles LinkButton sur une page Web et de déterminer par programme sur quel contrôle LinkButton un clic a été effectué. Vous pouvez également utiliser la propriété CommandArgument avec un bouton de commande 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 de commande.

Remarque :

Le contrôle LinkButton restitue du langage JavaScript sur le navigateur client. Le JavaScript doit être activé sur le navigateur client pour que ce contrôle fonctionne correctement. Pour plus d'informations sur le script client, consultez Script client dans les pages Web ASP.NET. Par défaut, la validation de page est effectuée lors d'un clic sur un contrôle LinkButton. 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 LinkButton qui doit désactiver ce comportement, par exemple un bouton reset, affectez à la propriété CausesValidation la valeur false.
Attention :

Le texte n'est pas codé au format HTML avant d'être affiché dans le contrôle LinkButton. Il est ainsi possible d'incorporer du script dans les balises HTML dans le texte. Si les valeurs du contrôle proviennent des entrées d'utilisateur, veillez à valider les valeurs pour permettre d'empêcher les failles en matière de sécurité.

Les boutons Command (tels que les contrôles LinkButton) sont fréquemment utilisés dans les contrôles basés sur des modèles pour communiquer une action au contrôle parent. Une sélection opérée dans un contrôle DataList ou le changement de mode dans un contrôle FormView en sont deux exemples.

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

Exemple

L'exemple suivant montre comment utiliser un contrôle LinkButton pour afficher un message lors d'un clic sur le contrôle.

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>LinkButton Example</title>
<script language="VB" runat="server">

      Sub LinkButton_Click(sender As Object, e As EventArgs) 
         Label1.Text = "You clicked the link button"
      End Sub

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>LinkButton Example</title>
<script language="C#" runat="server">

      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ Page Language="JScript" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>LinkButton Example</title>
<script language="JSCRIPT" runat="server">

      function LinkButton_Click(sender : Object, e : EventArgs){
         Label1.Text = "You clicked the link button"
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>

Voir aussi

Référence

LinkButton

Autres ressources

Syntaxe des contrôles serveur Web