Freigeben über

AdCreatedEventArgs.AdProperties Eigenschaft

Definition

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

Ruft ein IDictionary Objekt ab, das alle Ankündigungseigenschaften für die aktuell angezeigte Ankündigung enthält.

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

Eigenschaftswert

IDictionary

A IDictionary that contains a list of advertisement properties for the currently displayed advertisement. Der Standardwert ist Empty.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der AdProperties Eigenschaft im OnAdCreated Ereignishandler veranschaulicht, um eine benutzerdefinierte Beschriftung bereitzustellen.

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

Im folgenden Codebeispiel wird veranschaulicht, wie benutzerdefinierte Attribute zu einer Ankündigung in die XML-Ankündigungsdatei eingeschlossen werden. Weitere Informationen zur XML-Datei finden Sie in der AdvertisementFile Eigenschaft der AdRotator Klasse.

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

Hinweise

Verwenden Sie die AdProperties Eigenschaft, um ein System.Collections.IDictionary Objekt abzurufen, das die Anzeigeeigenschaften für die aktuell angezeigte Ankündigung enthält. Die Schlüssel und Werte des System.Collections.IDictionary Objekts sind vom Typ System.String.

Das AdRotator Steuerelement wählt bei jeder Anzeige des Steuerelements auf der Webseite zufällig eine Anzeige aus. Die Attribute für die ausgewählte Ankündigung werden aus der XML-Datei der Ankündigung extrahiert und in einem System.Collections.IDictionary Objekt gespeichert. Wenn das AdRotator Steuerelement eine neue Instanz der AdCreatedEventArgs Klasse erstellt, wird die AdProperties Eigenschaft mit dem System.Collections.IDictionary Objekt initialisiert.

Benutzerdefinierte Attribute zu einer Ankündigung, z. B. einer Ankündigungsbeschriftung, können auch in die XML-Datei der Ankündigung einbezogen werden. Verwenden Sie diese Eigenschaft im OnAdCreated Ereignishandler, um die benutzerdefinierten Attribute abzurufen.

Gilt für:

Weitere Informationen