Exporter (0) Imprimer
Développer tout

ImageButton, classe

Contrôle qui affiche une image et répond à des clics de souris sur l'image.

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

public class ImageButton : Image, IPostBackDataHandler, IPostBackEventHandler, IButtonControl
public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, 
	IButtonControl
public class ImageButton extends Image implements IPostBackDataHandler, IPostBackEventHandler, 
	IButtonControl

Utilisez le contrôle ImageButton pour afficher une image qui répond à des clics de souris.

Les deux événements Click et Command sont déclenchés à la suite d'un clic sur le contrôle ImageButton.

En utilisant le gestionnaire d'événements OnClick, vous pouvez déterminer par programme les coordonnées du point où un clic est effectué dans l'image. Vous pouvez ensuite coder une réponse, en fonction des valeurs des coordonnées. L'origine (0, 0) se trouve dans l'angle supérieur gauche de l'image.

Vous pouvez utiliser le gestionnaire d'événements OnCommand pour faire en sorte que le contrôle ImageButton se comporte comme un bouton de commande. Un nom de commande peut être associé au contrôle en utilisant la propriété CommandName. Cela permet de placer plusieurs contrôles ImageButton sur la même page Web. La valeur de la propriété CommandName peut ensuite être identifiée par programme dans le gestionnaire d'événements OnCommand pour déterminer l'action appropriée à effectuer à la suite d'un clic sur chaque contrôle ImageButton. La propriété CommandArgument peut également être utilisée pour passer des informations supplémentaires sur la commande, telle la spécification de l'ordre croissant.

Par défaut, la validation de la page est effectuée lorsqu'un clic est effectué sur un contrôle ImageButton. 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 de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Comment : ajouter un bouton de connexion à une page Web ASP.NETGénération d'applications Web ASP.NET
Comment : déterminer des coordonnées dans un contrôle serveur Web ImageButtonGénération d'applications Web ASP.NET
Comment : répondre à des événements Button dans des éléments des contrôles DataList, Repeater ou GridViewGé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 ButtonGénération d'applications Web ASP.NET
Comment : répondre aux événements de bouton dans des contrôles liés aux donnéesGé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 : ajouter des contrôles serveur Web ImageButton à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGé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
Comment : ajouter des contrôles serveur Web Button à une page Web FormsGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web ImageButton à une page Web FormsGé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 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 un bouton de connexion à une page Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web ImageButton à une page Web Forms (Visual Studio)Gé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 : liaison de données à un objet métier personnaliséGé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 ButtonGé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 de bouton dans des éléments DataList ou RepeaterGénération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer des coordonnées dans un contrôle serveur Web ImageButtonGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant illustre la création d'un contrôle ImageButton qui affiche les coordonnées à l'emplacement où un clic est effectué dans l'image.

RemarqueRemarque

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

   <script language="C#" runat="server">

      void ImageButton_Click(object sender, ImageClickEventArgs e) 
      {
         Label1.Text = "You clicked the ImageButton control at the coordinates: (" + 
                       e.X.ToString() + ", " + e.Y.ToString() + ")";
      }

   </script>

</head>

<body>

   <form runat="server">

      <h3>ImageButton Sample</h3>

      Click anywhere on the image.<br><br>

      <asp:ImageButton id="imagebutton1" runat="server"
           AlternateText="ImageButton 1"
           ImageAlign="left"
           ImageUrl="images/pict.jpg"
           OnClick="ImageButton_Click"/>

      <br><br>
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : LinkDemand. Valeur d'autorisation : Minimal.
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de la demande : InheritanceDemand. Valeur d'autorisation : Minimal.

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.Image
        System.Web.UI.WebControls.ImageButton

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

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft