AdCreatedEventArgs.AdProperties Proprietà

Definizione

Ottiene un oggetto IDictionary che contiene tutte le proprietà dell'annuncio pubblicitario attualmente visualizzato.Gets a IDictionary object that contains all the advertisement properties for the currently displayed advertisement.

public:
 property System::Collections::IDictionary ^ AdProperties { System::Collections::IDictionary ^ get(); };
public System.Collections.IDictionary AdProperties { get; }
member this.AdProperties : System.Collections.IDictionary
Public ReadOnly Property AdProperties As IDictionary

Valore della proprietà

Oggetto IDictionary che contiene un elenco delle proprietà dell'annuncio pubblicitario attualmente visualizzato.A IDictionary that contains a list of advertisement properties for the currently displayed advertisement. Il valore predefinito è Empty.The default value is Empty.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato AdProperties come utilizzare la OnAdCreated proprietà nel gestore eventi per fornire una didascalia personalizzata.The following code example demonstrates how to use the AdProperties property in the OnAdCreated event handler to provide a custom caption.

<%@ 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>
 
    <script language="c#" runat="server">
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {
          Message.Text=(string)e.AdProperties["Caption"];
       }      
    </script>
 
 <body>
 
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="test1" runat="server"
            AdvertisementFile = "Ads.xml"
        Borderwidth="1"
            Target="_newwwindow"
            OnAdCreated="AdCreated_Event"/><br /><br />
 
       <asp:label id="Message" runat="server"/>
 
    </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>
 
    <script language="vb" runat="server">
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
          Message.Text = e.AdProperties("Caption")
       End Sub     
    </script>
 
 <body>
 
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="test1" runat="server"
            AdvertisementFile = "Ads.xml"
        Borderwidth="1"
            Target="_newwwindow"
            OnAdCreated="AdCreated_Event"/><br /><br />
 
       <asp:label id="Message" runat="server"/>
 
    </form>
 
 </body>
 </html>


<Advertisements>
 
     <Ad>
         <ImageUrl>image1.jpg</ImageUrl>
         <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>image2.jpg</ImageUrl>
         <NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>
         <AlternateText>Wing Tip Toys</AlternateText>
         <Impressions>80</Impressions>
         <Keyword>Topic2</Keyword>
         <Caption>This is the caption for Ad#2</Caption>                
     </Ad>
 
 </Advertisements>

Nell'esempio di codice seguente viene illustrato come includere gli attributi personalizzati di un annuncio pubblicitario nel file XML dell'annuncio.The following code example demonstrates how to include custom attributes about an advertisement in the advertisement XML file. Per ulteriori informazioni sul file XML, vedere la AdvertisementFile proprietà AdRotator della classe.For more information on the XML file, see the AdvertisementFile property of the AdRotator class.

<Advertisements>  
 <Ad>  
 <ImageUrl>image1.jpg</ImageUrl>  
 <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>image2.jpg</ImageUrl>  
 <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 AdProperties proprietà per ottenere un System.Collections.IDictionary oggetto che contiene le proprietà dell'annuncio pubblicitario attualmente visualizzato.Use the AdProperties property to get a System.Collections.IDictionary object that contains the advertisement properties for the currently displayed advertisement. Le chiavi e i valori dell' System.Collections.IDictionary oggetto sono di tipo System.String.The keys and values of the System.Collections.IDictionary object are of type System.String.

Il AdRotator controllo Seleziona in modo casuale un annuncio ogni volta che il controllo viene visualizzato nella pagina Web.The AdRotator control randomly selects an advertisement each time the control is displayed on the Web page. Gli attributi per l'annuncio selezionato vengono estratti dal file XML dell'annuncio e archiviati in un System.Collections.IDictionary oggetto.The attributes for the selected advertisement are extracted from the advertisement XML file and stored in a System.Collections.IDictionary object. Quando il AdRotator controllo Crea una nuova istanza AdCreatedEventArgs della classe, la AdProperties proprietà viene inizializzata con l' System.Collections.IDictionary oggetto.When the AdRotator control creates a new instance of the AdCreatedEventArgs class, the AdProperties property gets initialized with the System.Collections.IDictionary object.

Gli attributi personalizzati di un annuncio pubblicitario, ad esempio una didascalia pubblicitaria, possono essere inclusi anche nel file XML dell'annuncio.Custom attributes about an advertisement, such as an advertisement caption, can also be included in the advertisement XML file. Usare questa proprietà nel OnAdCreated gestore eventi per ottenere gli attributi personalizzati.Use this property in the OnAdCreated event handler to get the custom attributes.

Si applica a

Vedi anche