AdCreatedEventArgs.AdProperties AdCreatedEventArgs.AdProperties AdCreatedEventArgs.AdProperties AdCreatedEventArgs.AdProperties Property

Definition

Ruft ein IDictionary-Objekt ab, das alle Eigenschaften der derzeit angezeigten Werbung enthält.Gets a IDictionary object that contains all the advertisement properties for the currently displayed advertisement.

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

Ein IDictionary, das eine Liste mit den Eigenschaften der derzeit angezeigten Werbung enthält.A IDictionary that contains a list of advertisement properties for the currently displayed advertisement. Der Standardwert ist Emptysein.The default value is Empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AdProperties -Eigenschaft OnAdCreated im-Ereignishandler verwendet wird, um eine benutzerdefinierte Beschriftung bereitzustellen.The following code example demonstrates how to use the AdProperties property in the OnAdCreated event handler to provide a custom caption.

<%@ 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 der XML-Ankündigungs Datei eingeschlossen werden.The following code example demonstrates how to include custom attributes about an advertisement in the advertisement XML file. Weitere Informationen zur XML-Datei finden Sie unter der AdvertisementFile -Eigenschaft AdRotator der-Klasse.For more information on the XML file, see the AdvertisementFile property of the AdRotator class.

<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 AdProperties die-Eigenschaft, System.Collections.IDictionary um ein-Objekt zu erhalten, das die Ankündigungs Eigenschaften der aktuell angezeigten Ankündigung enthält.Use the AdProperties property to get a System.Collections.IDictionary object that contains the advertisement properties for the currently displayed advertisement. Die Schlüssel und Werte des System.Collections.IDictionary -Objekts sind vom Typ. System.StringThe keys and values of the System.Collections.IDictionary object are of type System.String.

Das AdRotator -Steuerelement wählt nach dem Zufallsprinzip eine Ankündigung aus, wenn das Steuerelement auf der Webseite angezeigt wird.The AdRotator control randomly selects an advertisement each time the control is displayed on the Web page. Die Attribute für die ausgewählte Ankündigung werden aus der XML-Ankündigungs Datei extrahiert und in System.Collections.IDictionary einem-Objekt gespeichert.The attributes for the selected advertisement are extracted from the advertisement XML file and stored in a System.Collections.IDictionary object. Wenn das AdRotator -Steuerelement eine neue Instanz AdCreatedEventArgs der-Klasse erstellt AdProperties , wird die-Eigenschaft mit System.Collections.IDictionary dem-Objekt initialisiert.When the AdRotator control creates a new instance of the AdCreatedEventArgs class, the AdProperties property gets initialized with the System.Collections.IDictionary object.

Benutzerdefinierte Attribute zu einer Ankündigung (z. b. eine Ankündigungs Beschriftung) können auch in der XML-Ankündigungs Datei enthalten sein.Custom attributes about an advertisement, such as an advertisement caption, can also be included in the advertisement XML file. Verwenden Sie diese Eigenschaft im OnAdCreated -Ereignishandler, um die benutzerdefinierten Attribute zu erhalten.Use this property in the OnAdCreated event handler to get the custom attributes.

Gilt für:

Siehe auch