Condividi tramite

Sintassi dichiarativa per il controllo server Web AdRotator

  • Articolo

Aggiornamento: novembre 2007

Visualizza un banner pubblicitario in una pagina Web Form.

<asp:AdRotator
    AccessKey="string"
    AdvertisementFile="uri"
    AlternateTextField="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageUrlField="string"
    KeywordFilter="string"
    hrefField="string"
    OnAdCreated="AdCreated event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

Note

Il controllo AdRotator visualizza un banner pubblicitario in una pagina Web Form. Visualizza l'immagine specificata dall'elemento ImageUrl in un controllo di ancoraggio. In fase di esecuzione il controllo AdRotator utilizza i controlli <asp:HyperLink> and <asp:Image> per eseguire il rendering del controllo sulla pagina Web Form. Le dimensioni dell'immagine di origine vengono adattate dal browser in base alle dimensioni del controllo AdRotator indipendentemente dalle dimensioni effettive.

Se la proprietà AdvertisementFile è impostata, viene selezionato un annuncio in base al valore dell'elemento <Impressions> nel file. Quindi vengono impostati gli argomenti dell'evento e viene generato l'evento AdCreated. Se la proprietà AdvertisementFile non è impostata, gli argomenti dell'evento sono vuoti quando viene generato l'evento AdCreated. Gli argomenti dell'evento vengono utilizzati per eseguire il rendering del controllo AdRotator, in modo che sia possibile modificare i valori passati all'evento dal file di annunci oppure impostarli con valori generati dall'utente. Generalmente gli argomenti dell'evento vengono popolati con valori recuperati da un database.

Quando si crea un file di annunci, è necessario prendere in considerazione quanto segue:

  • È necessario che il file XML nel file di annunci abbia un formato corretto.

  • Solo il primo elemento <Advertisements> nel file viene analizzato dal controllo AdRotator. Tutti gli altri elementi <Advertisements> nel file vengono ignorati.

  • È possibile aggiungere elementi personalizzati alla descrizione XML di un annuncio. Questi valori vengono passati all'evento AdCreated nella proprietà di dizionario AdProperties.

È possibile utilizzare l'evento AdCreated per selezionare gli annunci direttamente nel codice oppure per modificare il rendering di un annuncio selezionato dal file di annunci. Se viene impostato un file di annunci, gli argomenti dell'evento AdCreated sono già impostati sull'annuncio selezionato quando viene richiamato l'evento. Indipendentemente dall'impostazione dei valori, è possibile modificare i valori nelle proprietà ImageUrl, href e AlternateText per modificare il rendering del controllo AdRotator. Gli elementi personalizzati aggiunti alla descrizione XML dell'annuncio sono disponibili nella proprietà di dizionario AdCreatedEventArgs.AdProperties.

Per informazioni dettagliate sulle proprietà e sugli eventi del controllo AdRotator, vedere la documentazione relativa a AdRotator.

Formato di file di annunci pubblicitari

Il controllo AdRotator utilizza un file di annunci XML distinto per memorizzare le informazioni relative all'annuncio, ad esempio il percorso dell'immagine da visualizzare e l'URL della pagina a cui effettuare il collegamento. La proprietà AdvertisementFile del controllo AdRotator specifica il percorso di questo file.

Quando si crea il file di annunci, i tag di apertura e di chiusura <Advertisements> indicano rispettivamente l'inizio e la fine del file. I tag di apertura e chiusura <Ad> delimitano ogni annuncio. Tutti gli annunci vengono nidificati tra i tag di apertura e chiusura <Advertisements>. Se il file contiene più tag <Advertisements>, solo il primo insieme di tag <Advertisements> nel file sarà analizzato dal controllo AdRotator. Tutti gli altri tag <Advertisements> saranno ignorati.

Gli elementi dei dati per ogni annuncio vengono nidificati tra i tag di apertura e chiusura <Ad>. Sebbene alcuni elementi dei dati siano predefiniti, come ImageUrl e href, è possibile inserire elementi personalizzati tra i tag <Ad>. Gli elementi vengono letti dal controllo AdRotator quando analizza il file. L'informazione viene quindi passata all'evento AdCreated nella proprietà di dizionario AdProperties.

Nella tabella seguente sono elencati gli elementi predefiniti dei dati per il file di annunci XML.

Elemento

Descrizione

<ImageUrl>

URL assoluto o relativo di un file di immagine (facoltativo).

<href>

URL di una pagina a cui l'utente si collega se fa clic sull'annuncio (facoltativo).

Nota

Se l'elemento non è impostato, il rendering della proprietà HRef non viene eseguito sul tag di ancoraggio.

<AlternateText>

Testo visualizzato al posto dell'immagine, se l'immagine specificata dalla proprietà ImageUrl non è disponibile (facoltativo).

In alcuni browser il testo viene visualizzato anche come un ToolTip dell'annuncio.

<Keyword>

Categoria (ad esempio "computer") in base alla quale è possibile filtrare l'annuncio (facoltativo).

<Impressions>

Numero che indica l'importanza dell'annuncio nella pianificazione di rotazione relativa agli altri annunci nel file (facoltativo).

Maggiore è il numero, più di frequente verrà visualizzato l'annuncio. Il totale di tutti i valori <Impressions> nel file XML non può essere superiore a 2.047.999.999. In questo caso il controllo AdRotator genera un'eccezione in fase di esecuzione.

Qui di seguito viene illustrato il formato del file di annunci XML.

<Advertisements>
   <Ad>
      <ImageUrl>
         URL of image to display for Advertisement #1
      </ImageUrl>
      <href>
         URL of page to link to for Advertisement #1
      </href>
      <AlternateText>
         Text to show as a ToolTip for Advertisement #1
      </AlternateText>
      <Keyword>
         Keyword used to filter for Advertisement #1
      </Keyword>
      <Impressions>
         Relative importance of Advertisement #1
      </Impressions>
      <CustomInformation>
         Custom Data about Advertisement #1
      </CustomInformation>
   </Ad>
</Advertisements>

Esempio

Nell'esempio riportato di seguito viene illustrato come dichiarare un controllo AdRotator in un file aspx.

<html>
 
   <head>
   </head>
 
<body>
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1"
           Target="_self"
           AdvertisementFile="Ads.xml"
           runat="server"/>
 
   </form>
</body>
 
</html>

Nell'esempio che segue viene illustrato come creare un gestore eventi per l'evento AdCreated per eseguire l'override del valore della proprietà href a livello di codice.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
      Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 

         e.href = "https://www.microsoft.com"   
       
      End Sub      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
      void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
      {

         e.href = "https://www.microsoft.com";   
       
      }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

Nell'esempio seguente viene mostrato come impostare il formato di un file di annunci XML.

<Advertisements>
 
   <Ad>
      <ImageUrl>image1.jpg</ImageUrl>
      <href>https://www.microsoft.com</href>
      <AlternateText>Microsoft Main Site</AlternateText>
      <Impressions>80</Impressions>
      <Keyword>Topic1</Keyword>
      <Caption>This is the caption for Ad#1</Caption> 
   </Ad>
 
   <Ad>
      <ImageUrl>image2.jpg</ImageUrl>
      <href>http://www.wingtiptoys.com</href>
      <AlternateText>Wing Tip Toys</AlternateText>
      <Impressions>80</Impressions>
      <Keyword>Topic2</Keyword>
      <Caption>This is the caption for Ad#2</Caption> 
   </Ad>
 
</Advertisements>

Vedere anche

Riferimenti

AdRotator

Altre risorse

Sintassi dei controlli server Web