Sdílet prostřednictvím

AdCreatedEventArgs.AdProperties Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

IDictionary Získá objekt, který obsahuje všechny inzerované vlastnosti pro aktuálně zobrazenou inzerování.

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

Hodnota vlastnosti

IDictionary

A IDictionary , který obsahuje seznam vlastností inzerování pro aktuálně zobrazenou reklamu. Výchozí hodnota je Empty.

Příklady

Následující příklad kódu ukazuje, jak použít AdProperties vlastnost v obslužné rutině OnAdCreated události poskytnout vlastní titulek.

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

Následující příklad kódu ukazuje, jak zahrnout vlastní atributy o inzerování v inzerovaném souboru XML. Další informace o souboru XML naleznete AdvertisementFileAdRotator vlastnost třídy.

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

Poznámky

AdProperties Vlastnost slouží k získání System.Collections.IDictionary objektu, který obsahuje vlastnosti inzerování pro aktuálně zobrazenou reklamu. Klíče a hodnoty objektu System.Collections.IDictionary jsou typu System.String.

Ovládací AdRotator prvek náhodně vybere reklamu při každém zobrazení ovládacího prvku na webové stránce. Atributy pro vybranou inzerci se extrahují ze souboru XML inzerované reklamy a uloží se do objektu System.Collections.IDictionary . Když ovládací AdRotator prvek vytvoří novou instanci AdCreatedEventArgs třídy, AdProperties vlastnost se inicializuje s objektem System.Collections.IDictionary .

Vlastní atributy týkající se reklamy, jako je například popisek reklamy, mohou být také zahrnuty do souboru XML pro inzerování. Tuto vlastnost použijte v obslužné rutině OnAdCreated události k získání vlastních atributů.

Platí pro

Viz také