AdCreatedEventArgs.AdProperties-Eigenschaft

Artikel
08/20/2007

Ruft ein System.Collections.IDictionary-Objekt ab, das alle Eigenschaften der derzeit angezeigten Werbung enthält.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public ReadOnly Property AdProperties As IDictionary
'Usage
Dim instance As AdCreatedEventArgs
Dim value As IDictionary

value = instance.AdProperties

public IDictionary AdProperties { get; }

public:
property IDictionary^ AdProperties {
    IDictionary^ get ();
}

/** @property */
public IDictionary get_AdProperties ()

public function get AdProperties () : IDictionary

Eigenschaftenwert

Ein System.Collections.IDictionary, das eine Liste mit den Eigenschaften der derzeit angezeigten Werbung enthält. Der Standardwert ist String.Empty.

Hinweise

Mit der AdProperties-Eigenschaft können Sie ein System.Collections.IDictionary-Objekt abrufen, das die Eigenschaften der aktuell angezeigten Werbung 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 eine Werbung nach dem Zufallsprinzip aus. Die Attribute der ausgewählten Werbung werden aus der XML-Datei für die Werbung 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 einer Werbung (z. B. die Beschriftung der Werbung) können ebenfalls in die XML-Datei für die Werbung aufgenommen werden. Sie können diese Eigenschaft im OnAdCreated-Ereignishandler zum Abrufen der benutzerdefinierten Attribute verwenden.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die AdProperties-Eigenschaft im OnAdCreated-Ereignishandler zum Bereitstellen einer benutzerdefinierten Beschriftung verwendet wird.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
 </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 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="C#" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="C#" runat="server">
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {
          Message.Text=(string)e.AdProperties["Caption"];
       }      
    </script>
 
 <body>
 
    <form 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="JScript" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="JScript" runat="server">
       function AdCreated_Event(sender, e : AdCreatedEventArgs) 
       {
          Message.Text=String(e.AdProperties["Caption"]);
       }      
    </script>
 
 <body>
 
    <form 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>
         <href>https://www.microsoft.com</href>
         <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>
         <href>http://www.wingtiptoys.com</href>
         <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 einer Werbung in die XML-Datei für die Werbung aufgenommen werden. Weitere Informationen zur XML-Datei finden Sie unter der AdvertisementFile-Eigenschaft der AdRotator-Schnittstelle.

 <Advertisements>
  <Ad>
  <ImageUrl>image1.jpg</ImageUrl>
  <href>https://www.microsoft.com</href>
  <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>
  <href>http://www.wingtiptoys.com</href>
  <AlternateText>Wingtip Toys</AlternateText>
  <Impressions>80</Impressions>
  <Keyword>Topic2</Keyword>
  <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
 </Advertisements>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AdCreatedEventArgs-Klasse
AdCreatedEventArgs-Member
System.Web.UI.WebControls-Namespace
AdRotator.AdvertisementFile
OnAdCreated
System.Collections.IDictionary
String.Empty

Freigeben über