AdCreatedEventArgs.AdProperties Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
IDictionary Získá objekt, který obsahuje všechny vlastnosti inzerování pro aktuálně zobrazenou reklamu.
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
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 k poskytnutí vlastní popis.
<%@ 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 reklamě v inzerovaném souboru XML. Další informace o souboru XML najdete ve AdvertisementFile vlastnosti AdRotator 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 použijte k získání objektuSystem.Collections.IDictionary, 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 reklamu jsou extrahovány z inzerovaného souboru XML a uloženy v objektu System.Collections.IDictionary . AdRotator Když ovládací prvek vytvoří novou instanci AdCreatedEventArgs třídy , AdProperties vlastnost se inicializuje s objektem System.Collections.IDictionary .
Vlastní atributy o reklamě, například reklamní popis, mohou být také zahrnuty do souboru XML pro inzerování. Pomocí této vlastnosti v obslužné rutině OnAdCreated události můžete získat vlastní atributy.