Aracılığıyla paylaş

AdCreatedEventArgs.AdProperties Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

O anda görüntülenen reklamın tüm tanıtım özelliklerini içeren bir IDictionary nesne alır.

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

Özellik Değeri

IDictionary

Şu IDictionary anda görüntülenen reklamın tanıtım özelliklerinin listesini içeren bir. Varsayılan değer Empty değeridir.

Örnekler

Aşağıdaki kod örneği, özel bir açıklamalı alt yazı sağlamak için olay işleyicisindeki OnAdCreated özelliğinin nasıl kullanılacağını AdProperties gösterir.

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

Aşağıdaki kod örneği, tanıtım XML dosyasına bir reklam hakkında özel özniteliklerin nasıl ekileceğini gösterir. XML dosyası hakkında daha fazla bilgi için sınıfının özelliğine AdRotator bakınAdvertisementFile.

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

Açıklamalar

AdProperties Şu anda görüntülenen reklamın tanıtım özelliklerini içeren bir System.Collections.IDictionary nesne almak için özelliğini kullanın. Nesnenin System.Collections.IDictionary anahtarları ve değerleri türündedir System.String.

Denetim AdRotator , Web sayfasında her görüntülendiğinde rastgele bir reklam seçer. Seçili reklamın öznitelikleri tanıtım XML dosyasından ayıklanır ve bir System.Collections.IDictionary nesnede depolanır. AdRotator Denetim sınıfının yeni bir örneğini oluşturduğunda AdCreatedEventArgsAdProperties, özelliği nesnesiyle System.Collections.IDictionary başlatılır.

Reklam başlığı gibi bir reklamla ilgili özel öznitelikler de tanıtım XML dosyasına eklenebilir. Özel öznitelikleri almak için olay işleyicisinde OnAdCreated bu özelliği kullanın.

Şunlara uygulanır

Ayrıca bkz.