AdRotator.AdvertisementFile Proprietà

Definizione

Ottiene o imposta il percorso del file XML che contiene le informazioni sull'annuncio pubblicitario.Gets or sets the path to an XML file that contains advertisement information.

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

Valore della proprietà

Posizione di un file XML che contiene informazioni sull'annuncio pubblicitario.The location of an XML file containing advertisement information. Il valore predefinito è una stringa vuota ("").The default value is an empty string ("").

Attributi

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà AdvertisementFile per specificare il percorso del file XML che contiene informazioni sull'annuncio.The following code example demonstrates how to use the AdvertisementFile property to specify the location of the XML file that contains advertisement information.

<%@ 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 riportato di seguito viene illustrato il formato del file di annuncio XML.The following code example shows the file format of the XML advertisement file.

<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à AdvertisementFile per specificare il percorso di un file XML che contiene informazioni sull'annuncio pubblicitario.Use the AdvertisementFile property to specify the location of an XML file that contains advertisement information. Il file XML deve trovarsi all'interno dello stesso sito Web.The XML file must reside within the same Web site. Per scopi di distribuzione e sicurezza, si consiglia vivamente di inserire il file nella stessa applicazione Web.For deployment and security purposes, it is strongly recommended that you place the file in the same Web application. È possibile accedere a un file XML che si trova in un'applicazione diversa nello stesso sito se l'applicazione dispone di attendibilità sufficiente.It is only possible to access an XML file that is located in a different application on the same site if the application has sufficient trust.

Questa proprietà può essere impostata su un percorso assoluto o su un percorso relativo al file XML.You can set this property to either an absolute path or a path relative to the XML file. Usare un percorso relativo per semplificare la distribuzione.Use a relative path to simplify deployment. Se si usa un percorso relativo, il percorso è relativo alla posizione della pagina o del controllo utente che contiene il controllo AdRotator.If you use a relative path, that path is relative to the location of the page or user control that contains the AdRotator control.

La proprietà AdvertisementFile è facoltativa.The AdvertisementFile property is optional. È anche possibile impostare a livello di codice un annuncio nell'evento AdCreated.An advertisement can also be programmatically set in the AdCreated event.

Il file XML contiene gli attributi predefiniti seguenti.The XML file contains the following predefined attributes. È necessario solo l'attributo ImageUrl.Only the ImageUrl attribute is required.

AttributoAttribute DescriptionDescription
ImageUrl URL dell'immagine da visualizzare.The URL of the image to display.
Height Altezza dell'immagine, in pixel (facoltativo).The height of the image, in pixels (optional).
Width Larghezza dell'immagine in pixel (facoltativo).The width of the image, in pixels (optional).
NavigateUrl URL della pagina a cui spostarsi quando si fa clic sul controllo AdRotator.The URL of the page to navigate to when the AdRotator control is clicked.
AlternateText Testo da visualizzare se l'immagine non è disponibile.The text to display if the image is unavailable. In alcuni browser questo testo viene visualizzato come descrizione comando.On some browsers, this text is displayed as a ToolTip.
Keyword Categoria per l'annuncio.The category for the advertisement. Viene utilizzato dal controllo AdRotator per filtrare l'elenco degli annunci per una categoria specifica.This is used by the AdRotator control to filter the list of advertisements for a specific category.
Impressions Valore che indica la frequenza di visualizzazione di un annuncio in relazione ad altri annunci nel file XML.A value that indicates how often an advertisement is displayed in relation to other advertisements in the XML file.

Nota

Gli attributi ImageUrl e NavigateUrl possono essere un URL completo, un percorso relativo radice o un percorso relativo.The ImageUrl and NavigateUrl attributes can be a full URL, a root-relative path, or a relative path. Se si usa un percorso relativo alla radice, il percorso è relativo allo stesso sito Web.If you use a root-relative path, the path is relative to the same Web site. Se si usa un percorso relativo, il percorso è relativo alla directory che contiene il file dell'annuncio.If you use a relative path, the path is relative to the directory that contains the advertisement file.

È inoltre possibile includere attributi personalizzati utilizzando tag personalizzati nel file XML.You can also include custom attributes by using custom tags in the XML file. Tutti i tag degli attributi vengono analizzati dal file di annuncio e i valori vengono inseriti nel dizionario AdProperties.All attribute tags are parsed from the advertisement file, and the values are placed in the AdProperties dictionary. È possibile utilizzare il dizionario AdProperties per accedere a livello di codice agli attributi personalizzati.You can use the AdProperties dictionary to programmatically access your custom attributes.

Le informazioni contenute in questo file non vengono convalidate dal controllo AdRotator.Information in this file is not validated by the AdRotator control. Per impedire che gli annunci eseguano script dannosi, è sempre necessario controllare i dati prima di rilasciarli oppure accettare le informazioni di Active Directory solo da origini attendibili.To prevent ads from executing malicious scripts, you should always check the data before releasing it, or accept ad information only from trusted sources.

Per proteggere il file dell'annuncio da accesso a Internet non autorizzato, effettuare una o più delle seguenti operazioni:To secure your advertisement file from unauthorized Internet access, do one or more of the following:

  • Archiviarlo nella directory dei dati, configurato in Machine. config per negare l'accesso a Internet per i file di qualsiasi tipo.Store it in the Data directory, which is configured in Machine.config to deny Internet access for files of any type.

  • Rinominare il file con un'estensione che non è XML ed eseguire il mapping dell'estensione a HttpForbiddenHandler in Web. config. Per ulteriori informazioni, vedere la sezione nel file Machine. config.Rename the file with an extension that is not .xml, and map the extension to HttpForbiddenHandler in Web.config. For more information, see the section in your Machine.config file.

Si applica a

Vedi anche