ASP:IMAGE |
ASP : Image |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:Image paramètres> </asp:Image> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AlternateText=valeur | Ce paramètre de balise permet d'indiquer un texte alternatif lorsque l'image n'est pas affiché. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| BorderColor=valeur | Ce paramètre permet d'indiquer la couleur de bordure de la balise. | ||
| BorderStyle=valeur | Ce paramètre permet d'indiquer le style de bordure de la balise : NotSet, None, Dotted, Dashed, Solid, Double, Groove, Ridge, Inset ou Outset. | ||
| BorderWidth=valeur | Ce paramètre permet d'indiquer la largeur de la bordure de la balise. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| DescriptionUrl=valeur | Ce paramètre permet d'indiquer un lien URL vers une description. | ||
| Enabled=valeur | Ce paramètre permet d'indiquer si la balise doit être active ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| "True" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| EnableTheming=valeur | Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le thème de la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que le thème de la balise est affiché. | ||
| EnableViewState=valeur | Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif. | ||
| "True" | Cette constante permet d'indiquer que le ViewState de la balise est actif. | ||
| ForeColor=valeur | Ce paramètre permet d'indiquer la couleur de premier plan de la balise. | ||
| GenerateEmptyAlternateText=valeur | Ce paramètre permet d'indiquer s'il faut générer le texte alternatif ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas générer le texte alternatif. | ||
| "True" | Cette constante permet d'indiquer qu'il faut générer le texte alternatif. | ||
| Height=valeur | Ce paramètre permet d'indiquer la hauteur de la balise. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| ImageAlign=alignement | Ce paramètre de balise permet de définir le type d'alignement horizontal que la cellule appliquera par défaut : | ||
| Constante | Description | ||
| "AbsBottom" | Cette constante indique que l'alignement absolue sera effectué à partir du bas | ||
| "AbsMiddle" | Cette constante indique que l'alignement absolue sera effectué à partir du milieu | ||
| "Baseline" | Cette constante indique que l'alignement sera effectué à partir de la ligne de base | ||
| "Bottom" | Cette constante indique que l'alignement sera effectué à partir du bas | ||
| "Left" | Cette constante indique que l'alignement sera effectuer à partir de la gauche | ||
| "Middle" | Cette constante indique que l'alignement sera effectué à partir du milieu | ||
| "NotSet" | Cette constante indique qu'il n'y a pas d'alignement | ||
| "Right" | Cette constante indique que l'alignement sera effectuer à partir de la droite | ||
| "TextTop" | Cette constante indique que l'alignement texte sera effectuer à partir du haut | ||
| "Top" | Cette constante indique que l'alignement sera effectuer à partir du haut | ||
| ImageUrl=valeur | Ce paramètre permet d'indiquer un lien URL vers l'image. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| OnDisposed=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition. | ||
| OnInit=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation. | ||
| OnLoad=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement. | ||
| OnPreRender=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu. | ||
| OnUnload=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| SkinID=valeur | Ce paramètre permet d'indiquer l'identificateur de Skin. | ||
| Style=valeur | Ce paramètre de balise permet d'indiquer des paramètres de feuille de style associé avec cette balise. | ||
| TabIndex=valeur | Ce paramètre de balise permet d'indiquer l'ordre de sélection des champs et éléments dans un formulaire. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| Visible=valeur | Ce paramètre permet d'indiquer si la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que la balise est affiché. | ||
| Width=valeur | Ce paramètre de balise permet d'indiquer la largeur de la balise. | ||
Description
Cette balise permet d'afficher une image.
Remarques
- Le contrôle <asp:Image> permet d'afficher une image dans une page Web, tout comme la balise <img> de HTML. Sa particularité est qu'il peut être manipulé côté serveur grâce à l'attribut runat="server".
- La propriété principale de ce contrôle est ImageUrl, qui détermine l'adresse de l'image à afficher. Cette URL peut pointer vers une ressource interne (comme une image dans un dossier du projet) ou une URL externe.
- Contrairement à une balise HTML classique, on peut modifier dynamiquement l'image affichée via le code-behind en changeant la valeur de ImageUrl en fonction des données, du contexte ou des préférences utilisateur.
- Il est possible de définir un texte alternatif à l'image via la propriété AlternateText. Ce texte est affiché si l'image ne se charge pas, et il améliore également l'accessibilité pour les lecteurs d'écran.
- Le contrôle Image peut être utilisé dans des interfaces dynamiques, par exemple dans un Repeater ou un GridView, pour afficher une image différente pour chaque enregistrement d'une base de données.
- Il peut également être utilisé pour afficher des icônes ou des statuts visuels dans une interface utilisateur, comme des coches vertes, des alertes ou des visuels représentant un état (connecté, inactif,...).
- Les dimensions de l'image peuvent être définies via les propriétés Width et Height. Ces dimensions peuvent être données en pixels ou en pourcentage, ce qui facilite l'adaptation de l'image à la mise en page.
- Le contrôle permet aussi d'ajouter une bordure via la propriété BorderWidth, ou de le styliser davantage en utilisant la propriété CssClass et des classes CSS personnalisées.
- Comme il est côté serveur, l'image peut être remplacée automatiquement selon certains événements comme le clic sur un bouton ou le chargement d'une autre section de la page.
- On peut conditionner son affichage en jouant avec la propriété Visible, très utile dans les scénarios où l'on veut afficher une image uniquement si certaines données sont présentes ou valides.
- Le contrôle est souvent utilisé pour créer des galeries d'images dynamiques, en liant sa ImageUrl à une source de données, ce qui permet d'afficher des albums photos, des miniatures ou des visuels produits.
- Si on souhaite interagir avec l'image (comme cliquer dessus), il vaut mieux utiliser le contrôle ImageButton qui combine les capacités d'affichage avec un événement serveur sur clic.
- Le contrôle asp:Image est parfaitement compatible avec les UpdatePanel, ce qui permet de mettre à jour l'image affichée sans recharger toute la page, dans une logique AJAX.
- Il peut être utilisé pour charger des graphiques ou des QR codes générés dynamiquement par le serveur. On attribue alors une URL pointant vers un gestionnaire (.ashx) ou une page générant une image à la volée.
- Dans un contexte multilingue, on peut utiliser asp:Image pour charger une image différente selon la culture de l'utilisateur, comme des drapeaux ou des messages localisés sous forme graphique.
Exemple
Voici un exemple permettant d'afficher une image :
- <%@ Page Language="vb" %>
- <!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">
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:Image id="Image1" runat="server" ImageURL="http://www.gladir.com/IMAGES/logo.gif" ToolTip="Logo"></asp:Image>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017