Partager via

AdRotator.AdvertisementFile Propriété

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 des informations de 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 de 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 publication. Le fichier XML doit résider dans le même site web. À des fins de déploiement et de sécurité, il est fortement recommandé de placer le fichier dans la même application web. Il est uniquement possible d’accéder à un fichier XML situé dans une autre application sur le même site si l’application dispose d’une confiance suffisante.

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.

Caractéristique 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 à accéder lorsque le AdRotator contrôle est cliqué.
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 à laquelle une publication est affichée par rapport à d’autres publicités dans le fichier XML.

Note

Les ImageUrl attributs et NavigateUrl les attributs 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 d’accès est relatif au même site web. Si vous utilisez un chemin 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 vérifier les données avant de les publier, ou accepter des informations publicitaires uniquement à partir de sources approuvées.

Pour sécuriser votre fichier publicitaire à partir d’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 n’importe quel type.
  • Renommez le fichier avec une extension qui n’est pas .xmlet mappez l’extension HttpForbiddenHandler dans Web.config. Pour plus d’informations, consultez la httpHandlers section de votre fichier Machine.config.

S’applique à

Voir aussi