AdCreatedEventArgs.AdProperties Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает объект IDictionary, содержащий все свойства отображаемого в данный момент объявления.
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
Значение свойства
Объект IDictionary, содержащий список свойств отображаемого в данный момент объявления. Значение по умолчанию — Empty.
Примеры
В следующем примере кода показано, как использовать AdProperties свойство в обработчике OnAdCreated событий для предоставления пользовательского подпись.
<%@ 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>
В следующем примере кода показано, как включить настраиваемые атрибуты объявления в XML-файл объявления. Дополнительные сведения о XML-файле см. в AdvertisementFile свойстве AdRotator класса .
<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>
Комментарии
Используйте свойство , AdProperties чтобы получить System.Collections.IDictionary объект , содержащий свойства объявления для текущего отображаемого объявления. Ключи и значения System.Collections.IDictionary объекта имеют тип System.String.
Элемент AdRotator управления случайным образом выбирает объявление каждый раз, когда элемент управления отображается на веб-странице. Атрибуты выбранного объявления извлекаются из XML-файла объявления и хранятся в объекте System.Collections.IDictionary . AdRotator Когда элемент управления создает новый экземпляр класса , AdProperties свойство инициализируется AdCreatedEventArgs с помощью System.Collections.IDictionary объекта .
Настраиваемые атрибуты объявления, такие как объявление подпись, также могут быть включены в XML-файл объявления. Используйте это свойство в обработчике OnAdCreated событий для получения настраиваемых атрибутов.