Condividi tramite

AdRotator.AdvertisementFile Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta il percorso del file XML che contiene le informazioni sull'annuncio pubblicitario.

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

Valore della proprietà

String

Posizione di un file XML che contiene informazioni sull'annuncio pubblicitario. Il valore predefinito è una stringa vuota ("").

Attributi
BindableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare la AdvertisementFile proprietà per specificare il percorso del file XML contenente informazioni pubblicitarie.

<%@ 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>

Nell'esempio di codice seguente viene illustrato il formato di file del file di annuncio 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>

Commenti

Utilizzare la proprietà per specificare il AdvertisementFile percorso di un file XML contenente informazioni pubblicitarie. Il file XML deve trovarsi nello stesso sito Web. Per scopi di distribuzione e sicurezza, è consigliabile inserire il file nella stessa applicazione Web. È possibile accedere solo a un file XML che si trova in un'applicazione diversa nello stesso sito se l'applicazione dispone di attendibilità sufficiente.

È possibile impostare questa proprietà su un percorso assoluto o su un percorso relativo al file XML. Usare un percorso relativo per semplificare la distribuzione. Se si usa un percorso relativo, tale percorso è relativo al percorso della pagina o del controllo utente che contiene il AdRotator controllo.

La proprietà AdvertisementFile è facoltativa. Un annuncio può anche essere impostato a livello di codice nell'evento AdCreated .

Il file XML contiene gli attributi predefiniti seguenti. È necessario solo l'attributo ImageUrl .

Attributo Descrizione
ImageUrl URL dell'immagine da visualizzare.
Height Altezza dell'immagine, in pixel (facoltativo).
Width Larghezza dell'immagine, in pixel (facoltativo).
NavigateUrl URL della pagina da passare a quando viene fatto clic sul AdRotator controllo.
AlternateText Testo da visualizzare se l'immagine non è disponibile. In alcuni browser questo testo viene visualizzato come descrizione comando.
Keyword Categoria per l'annuncio. Questo viene usato dal controllo per filtrare l'elenco AdRotator degli annunci per una categoria specifica.
Impressions Valore che indica la frequenza con cui viene visualizzato un annuncio pubblicitario in relazione ad altri annunci nel file XML.

Nota

Gli ImageUrl attributi e NavigateUrl possono essere un URL completo, un percorso relativo radice o un percorso relativo. Se si usa un percorso relativo radice, il percorso è relativo allo stesso sito Web. Se si usa un percorso relativo, il percorso è relativo alla directory contenente il file di annuncio.

È anche possibile includere attributi personalizzati usando tag personalizzati nel file XML. Tutti i tag di attributo vengono analizzati dal file di annuncio e i valori vengono inseriti nel AdProperties dizionario. È possibile usare il AdProperties dizionario per accedere a livello di codice agli attributi personalizzati.

Le informazioni in questo file non vengono convalidate dal AdRotator controllo. Per impedire agli annunci di eseguire script dannosi, è consigliabile controllare sempre i dati prima di rilasciarlo o accettare informazioni sugli annunci solo da origini attendibili.

Per proteggere il file pubblicitario dall'accesso a Internet non autorizzato, eseguire una o più delle operazioni seguenti:

  • Archiviarla nella directory Dati, configurata in Machine.config per negare l'accesso a Internet per i file di qualsiasi tipo.
  • Rinominare il file con un'estensione non .xml e eseguire il mapping dell'estensione a HttpForbiddenHandler in Web.config. Per altre informazioni, vedere la httpHandlers sezione nel file Machine.config.

Si applica a

Vedi anche