AdCreatedEventArgs.AdProperties Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft ein IDictionary-Objekt ab, das alle Eigenschaften der derzeit angezeigten Werbung 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

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AdProperties -Eigenschaft im OnAdCreated Ereignishandler verwendet wird, um eine benutzerdefinierte Untertitel 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 für eine Ankündigung in die XML-Datei der Ankündigung 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 Ankündigungseigenschaften 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 nach dem Zufallsprinzip eine Ankündigung aus. Die Attribute für die ausgewählte Ankündigung werden aus der Ankündigungs-XML-Datei extrahiert und in einem System.Collections.IDictionary -Objekt gespeichert. Wenn das AdRotator Steuerelement eine neue instance der AdCreatedEventArgs -Klasse erstellt, wird die AdProperties -Eigenschaft mit dem System.Collections.IDictionary -Objekt initialisiert.

Benutzerdefinierte Attribute für eine Ankündigung, z. B. eine Ankündigung Untertitel, können auch in die XML-Datei der Ankündigung eingeschlossen werden. Verwenden Sie diese Eigenschaft im OnAdCreated Ereignishandler, um die benutzerdefinierten Attribute abzurufen.

Gilt für:

Freigeben über