AdCreatedEventArgs.AdProperties Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u een IDictionary object op dat alle advertentie-eigenschappen voor de momenteel weergegeven advertentie bevat.

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

Waarde van eigenschap

IDictionary

Een IDictionary met een lijst met advertentie-eigenschappen voor de momenteel weergegeven advertentie. De standaardwaarde is Empty.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AdProperties eigenschap in de OnAdCreated gebeurtenis-handler gebruikt om een aangepast bijschrift op te geven.

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

In het volgende codevoorbeeld ziet u hoe u aangepaste kenmerken over een advertentie in het XML-bestand van de advertentie kunt opnemen. Zie de AdvertisementFile eigenschap van de AdRotator klasse voor meer informatie over het XML-bestand.

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

Opmerkingen

Gebruik de AdProperties eigenschap om een System.Collections.IDictionary object op te halen dat de advertentie-eigenschappen voor de momenteel weergegeven advertentie bevat. De sleutels en waarden van het object zijn van het System.Collections.IDictionary type System.String.

Het AdRotator besturingselement selecteert willekeurig een advertentie telkens wanneer het besturingselement wordt weergegeven op de webpagina. De kenmerken voor de geselecteerde advertentie worden geëxtraheerd uit het XML-bestand van de advertentie en opgeslagen in een System.Collections.IDictionary object. Wanneer het AdRotator besturingselement een nieuw exemplaar van de AdCreatedEventArgs klasse maakt, wordt de AdProperties eigenschap geïnitialiseerd met het System.Collections.IDictionary object.

Aangepaste kenmerken over een advertentie, zoals een advertentiebijschrift, kunnen ook worden opgenomen in het XML-bestand van de advertentie. Gebruik deze eigenschap in de OnAdCreated gebeurtenis-handler om de aangepaste kenmerken op te halen.

Van toepassing op

Zie ook