AdRotator.AdvertisementFile Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit le chemin d'accès à un fichier XML qui contient les informations relatives à une publication.

public:
 property System::String ^ AdvertisementFile { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string AdvertisementFile { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.AdvertisementFile : string with get, set
Public Property AdvertisementFile As String

Valeur de propriété

String

Emplacement d'un fichier XML contenant des informations relatives à une publication. La valeur par défaut est une chaîne vide ("").

Attributs
BindableAttribute

Exemples

L’exemple de code suivant montre comment utiliser la AdvertisementFile propriété pour spécifier l’emplacement du fichier XML qui contient des informations de publication.

<%@ 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 runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

<%@ Page Language="VB" 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 runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

L’exemple de code suivant montre le format de fichier du fichier de publication XML.

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/image1.jpg</ImageUrl>  
    <Height>60</Height>  
    <Width>190</Width>  
    <NavigateUrl>http://www.microsoft.com</NavigateUrl>  
    <AlternateText>Microsoft Main Site</AlternateText>  
    <Impressions>80</Impressions>  
    <Keyword>Topic1</Keyword>  
    <Caption>This is the caption for Ad#1</Caption>   
  </Ad>  
  <Ad>  
    <ImageUrl>~/Images/image2.jpg</ImageUrl>  
    <Height>90</Height>  
    <Width>90</Width>  
    <NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>  
    <AlternateText>Wingtip Toys</AlternateText>  
    <Impressions>80</Impressions>  
    <Keyword>Topic2</Keyword>  
    <Caption>This is the caption for Ad#2</Caption>   
  </Ad>  
</Advertisements>

Remarques

Utilisez la AdvertisementFile propriété pour spécifier l’emplacement d’un fichier XML qui contient des informations de publicité. Le fichier XML doit résider dans le même site web. À des fins de déploiement et de sécurité, il est vivement recommandé de placer le fichier dans la même application web. Il n’est possible d’accéder à un fichier XML qui se trouve dans une autre application sur le même site que si l’application a suffisamment d’approbation.

Vous pouvez définir cette propriété sur un chemin absolu ou un chemin d’accès relatif au fichier XML. Utilisez un chemin relatif pour simplifier le déploiement. Si vous utilisez un chemin relatif, ce chemin est relatif à l’emplacement de la page ou du contrôle utilisateur qui contient le AdRotator contrôle.

La propriété AdvertisementFile est facultative. Une publicité peut également être définie par programmation dans l’événement AdCreated .

Le fichier XML contient les attributs prédéfinis suivants. Seul l’attribut ImageUrl est requis.

Attribut Description
ImageUrl URL de l’image à afficher.
Height Hauteur de l’image, en pixels (facultatif).
Width Largeur de l’image, en pixels (facultatif).
NavigateUrl URL de la page à laquelle accéder lorsque vous cliquez sur le AdRotator contrôle.
AlternateText Texte à afficher si l’image n’est pas disponible. Sur certains navigateurs, ce texte s’affiche sous forme d’info-bulle.
Keyword Catégorie de la publicité. Il est utilisé par le AdRotator contrôle pour filtrer la liste des publicités pour une catégorie spécifique.
Impressions Valeur qui indique la fréquence d’affichage d’une publicité par rapport à d’autres publicités dans le fichier XML.

Notes

Les ImageUrl attributs et NavigateUrl peuvent être une URL complète, un chemin d’accès relatif racine ou un chemin relatif. Si vous utilisez un chemin d’accès relatif racine, le chemin est relatif au même site Web. Si vous utilisez un chemin d’accès relatif, le chemin d’accès est relatif au répertoire qui contient le fichier de publication.

Vous pouvez également inclure des attributs personnalisés à l’aide de balises personnalisées dans le fichier XML. Toutes les balises d’attribut sont analysées à partir du fichier de publication et les valeurs sont placées dans le AdProperties dictionnaire. Vous pouvez utiliser le AdProperties dictionnaire pour accéder par programmation à vos attributs personnalisés.

Les informations contenues dans ce fichier ne sont pas validées par le AdRotator contrôle. Pour empêcher les publicités d’exécuter des scripts malveillants, vous devez toujours case activée les données avant de les publier, ou accepter les informations publicitaires uniquement à partir de sources approuvées.

Pour sécuriser votre fichier publicitaire contre un accès Internet non autorisé, effectuez une ou plusieurs des opérations suivantes :

  • Stockez-le dans le répertoire De données, qui est configuré dans Machine.config pour refuser l’accès à Internet pour les fichiers de tout type.
  • Renommez le fichier avec une extension qui n’est pas .xml, puis mappez l’extension à HttpForbiddenHandler dans Web.config. Pour plus d’informations, consultez la httpHandlers section de votre fichier Machine.config.

S’applique à

Voir aussi