Exporter (0) Imprimer
Développer tout

LinkButton, classe

Mise à jour : novembre 2007

Affiche un contrôle bouton de style lien hypertexte sur une page Web.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class LinkButton : WebControl, IButtonControl, 
	IPostBackEventHandler
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class LinkButton extends WebControl implements IButtonControl, 
	IPostBackEventHandler
public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler
<asp:LinkButton />

Utilisez le contrôle LinkButton pour créer un bouton de style lien hypertexte sur la page Web. Le contrôle LinkButton a la même apparence qu'un contrôle HyperLink, mais la même fonctionnalité qu'un contrôle Button. Envisagez d'utiliser le contrôle HyperLink si vous souhaitez établir un lien à une autre page Web suite à un clic sur le contrôle.

Remarque :

Le contrôle LinkButton retourne du code JavaScript au navigateur client. JavaScript doit être activé sur le navigateur client pour que ce contrôle fonctionne correctement. Pour plus d'informations sur les scripts clients, consultez Script client dans les pages Web ASP.NET.

Vous pouvez créer un bouton de type "Submit" ou un bouton de commande. Aucun nom de commande n'est associé à un bouton de type "Submit". Le bouton publie simplement la page Web sur le serveur. Par défaut, un contrôle LinkButton est un bouton de type "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 de type "Submit". Par contre, un bouton Commande possède un nom de commande qui lui est associé, tel que Sort. Définissez la propriété CommandName pour spécifier le nom de commande. 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 Commande pour fournir des informations supplémentaires sur la commande à exécuter (telle que la spécification de l'ordre croissant). Vous pouvez également fournir un gestionnaire d'événements pour l'événement Command afin de contrôler par programme l'action exécutée suite à un clic sur le bouton Commande.

Attention :

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent contenir un script client malveillant. Recherchez dans toutes les informations envoyées par un client un script exécutable, des instructions SQL ou tout autre code avant de les afficher dans votre application. ASP.NET fournit une fonctionnalité de validation de demande d'entrée pour bloquer les scripts et le code HTML dans les entrées d'utilisateur. Des contrôles serveur de validation sont également fournis pour valider les entrées de l'utilisateur. Pour plus d'informations, consultez la page Syntaxe des contrôles serveur de validation.

Par défaut, une validation de page est effectuée suite à un clic sur le contrôle LinkButton. Une validation de page détermine si tous les contrôles d'entrée associés à un contrôle de validation sur la page respectent les règles de validation spécifiées par le contrôle de validation. Pour empêcher la validation de page de se produire, affectez la valeur false à la propriété CausesValidation.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions WCAG (Web Content Accessibility Guidelines) 1.0 de priorité 1. Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

TopicLocation
Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux clics d'utilisateur dans les contrôles serveur Web BulletedList (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux événements de bouton dans des contrôles liés aux donnéesGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements du contrôle serveur Web ButtonGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web Button à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements du contrôle serveur Web bouton dans un script clientGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Comment : ajouter des contrôles serveur Web Button à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des événements du contrôle serveur Web ButtonGénération d'applications Web ASP.NET
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre aux événements de bouton dans des contrôles liés aux donnéesGénération d'applications Web ASP.NET
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : répondre à des événements du contrôle serveur Web bouton dans un script clientGénération d'applications Web ASP.NET

L'exemple suivant illustre la création d'un contrôle LinkButton qui affiche du texte dans un contrôle Label suite à un clic sur le lien.

<%@ 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>



Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft