Link, contrôle

Article
04/11/2008

Crée un contrôle à base de texte, de sortie uniquement, qui représente un lien hypertexte vers un autre contrôle Form situé sur une page mobile ou dans une URL arbitraire.

Sur tous les périphériques, un lien est rendu de telle sorte que la propriété Text soit présentée à l'utilisateur. Lorsque ce dernier clique sur le lien, le contrôle passe à la page indiquée dans la propriété NavigateURL spécifiée. Si la propriété Text n'est pas définie, la valeur par défaut du lien correspond à la propriété AlternateURL.

Syntaxe des contrôles mobiles

Les propriétés, valeurs par défaut et éléments de code requis sont indiqués en caractères gras.

<mobile:Linkrunat="server"
   id="id"
   Font-Name="fontName"
   Font-Size="{NotSet|Normal|Small|Large}"
   Font-Bold="{NotSet|False|True}"
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   StyleReference="styleReference"
   Text="Text"
   Wrapping="{NotSet|Wrap|NoWrap}"

   NavigateUrl="relativeLink"
   SoftkeyLabel="softkeyLabel">
innerText
</mobile:Link>

Règles relatives à la relation contenant-contenu

Les contrôles suivants peuvent contenir un contrôle Link.

Contrôle	Commentaires
System.Web.UI.MobileControls.Form	Peut contenir n'importe quel nombre de contrôles Link.
System.Web.UI.MobileControls.Panel	Peut contenir n'importe quel nombre de contrôles Link.

Le contrôle Link ne peut pas contenir d'autres contrôles.

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Langage du périphérique Description du comportement

HTML Au moment de l'exécution, le contrôle Link affiche un lien sous la forme d'une balise HTML standard <a> (ancre), sauf si le lien commence par le signe dièse (#) ; dans ce cas, il est rendu sous la forme d'un événement de publication. Une balise <br> (saut de ligne) suit le lien.

WML

Langage du périphérique	Description du comportement
HTML	Au moment de l'exécution, le contrôle Link affiche un lien sous la forme d'une balise HTML standard <a> (ancre), sauf si le lien commence par le signe dièse (#) ; dans ce cas, il est rendu sous la forme d'un événement de publication. Une balise <br> (saut de ligne) suit le lien.
WML	En langage WML, un lien génère le type de balisage suivant : `<a NavigateUrl="postbackinfo">TextProperty</a>` Si la valeur du lien commence par un signe dièse (#), ce dernier est rendu sous la forme d'un événement de publication. Une balise <br> (saut de ligne) suit le lien.

En langage WML, un lien génère le type de balisage suivant :

<a NavigateUrl="postbackinfo">TextProperty</a>

Si la valeur du lien commence par un signe dièse (#), ce dernier est rendu sous la forme d'un événement de publication. Une balise <br> (saut de ligne) suit le lien.

Exemple

L'exemple suivant contient un formulaire unique qui possède un seul lien.

<%@ Page Inherits= "System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<mobile:Form runat="server">
  <mobile:Link runat="server" 
   NavigateURL="http://mobile.msn.com">My Favorite Mobile Site</mobile:Link>
</mobile:Form>

Voir aussi

Link, classe | Link, membres de classe | Guide de référence des contrôles

Partager via