Partager via

AdRotator, contrôle

  • Article

Le contrôle mobile AdRotator offre une fonctionnalité de rotation des publicités similaire au contrôle ASP.NET Web Forms AdRotator ; par ailleurs, il fournit également un rendu adaptable pour les périphériques mobiles.

Remarque   Le contrôle AdRotator est indépendant du type de fichier image que vous utilisez pour la publicité. Vous pouvez utiliser n'importe quel type de fichier image compatible avec le navigateur cible.

Fonctionnalité de rendu d'images de remplacement

Le contrôle AdRotator peut afficher des images de remplacement sur divers périphériques. Par exemple, pour pouvoir afficher la même image sur deux types de périphériques différents, l'un affichant du code HTML et l'autre du code WML, vous pouvez utiliser l'élément <DeviceSpecific> afin de spécifier une propriété ImageKey différente pour chaque périphérique cible. Dans la construction DeviceSpecific/Choice, vous spécifiez le type de format de fichier dont l'affichage est pris en charge sur le périphérique cible. Pour plus d'informations sur la spécification d'images différentes, consultez la classe AdRotator.

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:AdRotatorrunat="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"
   Wrapping="{NotSet|Wrap|NoWrap}"

   AdvertisementFile="relativeURL"
   ImageKey="imageKey"
   KeywordFilter="keywordFilter"
   NavigateUrlKey="navigateUrlKey"
   OnAdCreated="clickHandler">
Place DeviceSpecific/Choice construct here. (optional)
</mobile:AdRotator>

Format du fichier de publication

<?xml version="1.0" ?>
<Advertisements>
   [<Ad>
     <ImageUrl>The URL of the image to display</ImageUrl>
     <NavigateUrl>The URL of the page to display</NavigateUrl>
     [<OptionalImageUrl>URL of monochrome image to display</OptionalImageUrl>]*
     [<OptionalNavigateUrl>URL of page to display</OptionalNavigateUrl>]*
     <AlternateText>The text to display as a ToolTip</AlternateText>
     <Keyword>The keyword used to filter</Keyword>
     <Impressions>
       The relative weighting of the advertisement
     </Impressions>
   </Ad>]*
</Advertisements>

Vous devez vous souvenir des points ci-dessous lorsque vous créez un fichier de publication :

  • Le code XML doit être correct.
  • Le fichier peut comporter plusieurs éléments <Ad>, mais il ne doit contenir qu'un seul élément <Advertisements>. La présence de plusieurs éléments <Advertisements> génère une erreur ; par ailleurs, les éléments <Advertisements> imbriqués sont ignorés.
  • L'élément ImageUrl contient une URL absolue ou relative (par rapport à l'emplacement du fichier Ads.xml), qui pointe vers le fichier image affiché pour la publicité, lorsque aucun élément ImageKey ne correspond à un élément OptionalImageUrl.
  • L'élément OptionalImageUrl contient une URL absolue ou relative (par rapport à l'emplacement du fichier Ads.xml) qui pointe vers le fichier image affiché pour la publicité, lorsqu'il existe une correspondance avec un élément ImageKey (facultatif). Vous pouvez en posséder autant que nécessaire pour votre application.
  • L'élément NavigateUrl contient l'URL de la page vers laquelle l'utilisateur est renvoyé, lorsqu'il clique sur la publicité et qu'aucun élément NavigateUrlKey ne correspond à un élément OptionalNavigateUrl (facultatif). Si cet élément n'est pas défini, la propriété HREF n'est pas rendue dans la balise d'ancrage.
  • L'élément OptionalNavigateUrl contient l'URL de la page vers laquelle l'utilisateur est renvoyé, lorsqu'il clique sur la publicité et qu'il existe un élément NavigateUrlKey correspondant (facultatif). Vous pouvez en posséder autant que nécessaire pour votre application.
  • L'élément AlternateText contient l'attribut ALT de l'image (facultatif). Dans certains navigateurs, ce texte s'affiche sous forme d'info-bulle relative à la publicité. Il s'affiche également si l'image spécifiée dans la propriété ImageUrl est introuvable.
  • L'élément Keyword spécifie une catégorie de publicité (par exemple, « ordinateurs »), ce qui vous permet de filtrer les publicités (facultatif).
  • L'élément Impressions est un nombre qui indique le poids de la publicité dans le calendrier de rotation, par rapport aux autres publicités du fichier (facultatif). Plus le nombre est élevé, plus la publicité est affichée. Le total de tous les nombres contenus dans la propriété Impressions ne doit pas dépasser 2 048 000 000–1. Dans le cas contraire, le contrôle AdRotator lève une exception runtime.

Images de publicité multiples

Le contrôle AdRotator peut être utilisé avec des publicités qui affichent des images de remplacement sur différents périphériques. Pour prendre en charge ce type de publicité, effectuez les étapes suivantes :

  1. Déclarez un élément <DeviceSpecific> dans le contrôle AdRotator.
  2. Pour chaque classe de périphérique particulière, déclarez un élément <Choice> dans l'élément <DeviceSpecific>, définissez la propriété filter de manière appropriée, puis affectez un nom unique à l'attribut ImageKey.
  3. Outre la propriété ImageUrl standard, chaque entrée de publicité dans le fichier de configuration AdRotator doit contenir un élément pour chaque classe de périphérique spécifiée, portant le même nom que l'attribut ImageKey correspondant, lequel contient l'URL de l'image appropriée.

Au moment de l'exécution, une fois la classe de périphérique choisie, le contrôle utilise l'élément correspondant dans l'entrée de publicité pour déterminer l'URL de l'image. Dans le cas contraire, l'image par défaut de l'élément <ImgeUrl> est choisie.

Règles relatives à la relation contenant-contenu

Les règles de la relation contenant-contenu pour toutes les classes concrètes dérivées de la classe AdRotator sont identiques. Elles sont affichées dans le tableau ci-dessous. Les contrôles suivants peuvent contenir un contrôle AdRotator.

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

Le contrôle AdRotator peut contenir les contrôles ci-dessous.

Contrôle Commentaires
System.Web.UI.MobileControls.DeviceSpecific Spécifie les images de remplacement par périphérique.

Un contrôle AdRotator ne contient qu'un seul contrôle DeviceSpecific, voire aucun.

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Pour toutes les cibles, le contrôle AdRotator choisit une publicité dans le fichier de publication. En fonction du mot clé contenu dans l'élément Keyword, le contrôle AdRotator utilise les informations des éléments contenus dans l'élément de publicité pour définir la propriété correspondante du contrôle :

  • ImageKey.   Cette propriété a la valeur de l'élément ImageUrl.
  • NavigateUrlKey.   Cette propriété a la valeur de l'élément NavigateUrl.
  • KeywordFilter.   Cette propriété a la valeur de l'élément Keyword.

La substitution de la propriété ImageKey pour des périphériques spécifiques fournit une fonctionnalité en fonction de chaque périphérique. Dans l'exemple ci-dessous, l'instruction <DeviceSpecific> spécifie que les périphériques qui n'affichent que des images monochromes doivent recevoir le lien vers le fichier image monochrome. Lorsque vous utilisez des informations spécifiques au périphérique, vous devez suivre les indications fournies dans la rubrique Rendu spécifique au périphérique pour ajouter des filtres de périphérique au fichier web.config.

Exemple

L'exemple de code suivant crée un contrôle AdRotator qui traite un fichier de publication et affiche les publicités dans un ordre aléatoire. Pour exécuter correctement ce contrôle, vous devez fournir les images ainsi que le code XML qui les appelle et les lie à la page d'accueil de la société. Un exemple de fichier XML est donné après l'exemple d'utilisation de AdRotator.

[Visual Basic, C#]

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

<mobile:Form runat="server">
  <mobile:AdRotator runat="server" AdvertisementFile="Ads.xml"/>
   <DeviceSpecific>
    <Choice Filter="isMonochrome" ImageKey="monoImageUrl"/>
   </DeviceSpecific>
  <mobile:Label runat="server">
   The advertisement is refreshed every time you reload this page.
  </mobile:Label>
</mobile:Form>

Le code ci-dessous est un exemple de fichier de publication, Ads.xml.

<?xml version="1.0"?>
<Advertisements>
  <Ad>
   <ImageUrl>Ads/Microsoft.gif</ImageUrl>
   <MonoImageUrl>Ads/Microsoft_bw.gif</MonoImageUrl>
   <NavigateUrl>https://www.Microsoft.com</NavigateUrl>
   <AlternateText>Software: Microsoft</AlternateText>
   <KeywordFilter>software</KeywordFilter>
   <Impressions>80</Impressions>
  </Ad>
  <Ad>
   <ImageUrl>Place second image here</ImageUrl>
   <NavigateUrl>Place second URL here</NavigateUrl>
   <AlternateText>Place alternate text here</AlternateText>
   <KeywordFilter>keyword</KeywordFilter>
   <Impressions>80</Impressions>
  </Ad>
</Advertisements>

Voir aussi

AdRotator, classe | AdRotator, membres de classe | Guide de référence des contrôles | Sélection au moment de l'exécution de publicités dans un contrôle serveur Web AdRotator