Deklarative Syntax des AdRotator-Webserversteuerelements

  • Artikel

Aktualisiert: November 2007

Zeigt ein Werbebanner auf einer Web Forms-Seite an.

<asp:AdRotator
    AccessKey="string"
    AdvertisementFile="uri"
    AlternateTextField="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageUrlField="string"
    KeywordFilter="string"
    hrefField="string"
    OnAdCreated="AdCreated event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

Hinweise

Das AdRotator-Steuerelement zeigt ein Werbebanner auf einer Web Forms-Seite an. Es zeigt das Bild an, das im ImageUrl-Element innerhalb eines Ankersteuerelements angegeben ist. Zur Laufzeit verwendet das AdRotator-Steuerelement zur Darstellung des Steuerelements auf der Web Forms-Seite <asp:HyperLink>-Steuerelemente und <asp:Image>-Steuerelemente. Die Größe des Quellbilds wird unabhängig von seiner tatsächlichen Größe durch den Browser an die Maße des AdRotator-Steuerelements angepasst.

Wenn die AdvertisementFile-Eigenschaft festgelegt ist, wird basierend auf dem Wert des <Impressions>-Elements eine Werbeanzeige aus der Datei ausgewählt. Anschließend werden die Ereignisargumente festgelegt, und das AdCreated-Ereignis wird ausgelöst. Wenn die AdvertisementFile-Eigenschaft nicht festgelegt ist, sind die Ereignisargumente beim Auslösen des AdCreated-Ereignisses leer. Die Ereignisargumente werden zur Darstellung des AdRotator-Steuerelements verwendet. Sie können also die Werte, die von dem Ereignis an die Werbeanzeigedatei übergeben werden, verändern oder selbst Werte generieren. Die gängige Vorgehensweise besteht darin, die Ereignisargumente mit Werten aufzufüllen, die aus einer Datenbank abgerufen werden.

Beachten Sie beim Erstellen einer Werbeanzeigedatei die folgenden Punkte:

  • Der XML-Code in der Werbeanzeigedatei muss wohlgeformt sein.

  • Nur das erste <Advertisements>-Element in der Datei wird durch das AdRotator-Steuerelement analysiert. Alle anderen <Advertisements>-Elemente in der Datei werden ignoriert.

  • Sie können der XML‑Beschreibung einer Werbeanzeige benutzerdefinierte Elemente hinzufügen. Diese Werte werden an das AdCreated-Ereignis in der AdProperties-Wörterbucheigenschaft übergeben.

Mit dem AdCreated-Ereignis können Sie die Werbeanzeigen direkt im Code auswählen sowie die Darstellung einer aus der Werbeanzeigedatei ausgewählten Anzeige ändern. Wenn eine Werbeanzeigedatei festgelegt ist, ist für die Argumente des AdCreated-Ereignisses bereits die ausgewählte Anzeige festgelegt, wenn das Ereignis aufgerufen wird. Unabhängig davon, ob die Werte bereits festgelegt wurden, können Sie den Wert der ImageUrl-Eigenschaft, der href-Eigenschaft und der AlternateText-Eigenschaft ändern, um die Darstellung des AdRotator-Steuerelements zu beeinflussen. Benutzerdefinierte Elemente, die der XML-Beschreibung der Werbeanzeige hinzugefügt werden können, befinden sich in der AdCreatedEventArgs.AdProperties-Wörterbucheigenschaft.

Ausführliche Informationen zu den Eigenschaften und Ereignissen des AdRotator-Steuerelements finden Sie in der Dokumentation zu AdRotator.

Format der Werbeanzeigedatei

Das AdRotator-Steuerelement speichert die Werbeanzeigeinformationen, z. B. die Position des anzuzeigenden Bildes und den URL der Seite, auf die der Link verweist, in einer separaten XML-Werbeanzeigedatei. Die AdvertisementFile-Eigenschaft des AdRotator-Steuerelements gibt den Pfad zu dieser Datei an.

Beim Erstellen der Werbeanzeigedatei markieren das <Advertisements>-Start- und Endtag den Beginn bzw. das Ende der Datei. Die einzelnen Werbeanzeigen werden durch <Ad>-Start- und Endtags begrenzt. Alle Werbeanzeigen werden in das <Advertisements>-Start- und Endtag eingeschlossen. Wenn die Datei mehrere <Advertisements>-Tags enthält, wird nur der erste Satz von <Advertisements>-Tags in der Datei durch das AdRotator-Steuerelement analysiert. Alle übrigen <Advertisements>-Tags werden ignoriert.

Die Datenelemente für jede Werbeanzeige werden in <Ad>-Start- und Endtags eingeschlossen. Obwohl bestimmte Datenelemente vordefiniert sind (wie ImageUrl und href), können Sie zwischen den <Ad>-Tags benutzerdefinierte Elemente einfügen. Diese Elemente werden vom AdRotator-Steuerelement bei der Analyse der Datei gelesen. Diese Informationen werden anschließend an das AdCreated-Ereignis in der AdProperties-Wörterbucheigenschaft übergeben.

In der folgenden Tabelle werden die Datenelemente aufgelistet, die für die XML‑Werbeanzeigedatei vordefiniert sind.

Element

Beschreibung

<ImageUrl>

Der absolute oder relative URL einer Bilddatei (optional).

<href>

Der URL einer Seite, auf die der Link verweisen soll, wenn der Benutzer auf die Anzeige klickt (optional).

Tipp

Wenn dieses Element nicht festgelegt ist, wird die HRef-Eigenschaft auf dem Ankertag nicht dargestellt.

<AlternateText>

Der Text, der anstelle des Bilds angezeigt wird, wenn das durch die ImageUrl-Eigenschaft angegebene Bild nicht verfügbar ist (optional).

Bei einigen Browsern wird dieser Text auch als ToolTip für die Werbeanzeige angezeigt.

<Keyword>

Eine Kategorie für die Werbeanzeige (z. B. "Computer"), nach der Sie filtern können (optional).

<Impressions>

Eine Zahl, die die Priorität der Anzeige im Wechselzeitplan im Vergleich zu den anderen Anzeigen in der Datei angibt.

Je höher die Zahl ist, desto häufiger wird die Werbeanzeige gezeigt. Die Summe aller <Impressions>-Werte in einer XML-Datei darf 2.047.999.999 nicht übersteigen. Wenn die Summe größer ist, löst das AdRotator-Steuerelement eine Laufzeitausnahme aus.

Das folgende Beispiel veranschaulicht das Format der XML‑Werbeanzeigedatei.

<Advertisements>
   <Ad>
      <ImageUrl>
         URL of image to display for Advertisement #1
      </ImageUrl>
      <href>
         URL of page to link to for Advertisement #1
      </href>
      <AlternateText>
         Text to show as a ToolTip for Advertisement #1
      </AlternateText>
      <Keyword>
         Keyword used to filter for Advertisement #1
      </Keyword>
      <Impressions>
         Relative importance of Advertisement #1
      </Impressions>
      <CustomInformation>
         Custom Data about Advertisement #1
      </CustomInformation>
   </Ad>
</Advertisements>

Beispiel

Das folgende Beispiel veranschaulicht die Deklaration eines AdRotator-Steuerelements in einer ASPX-Datei.

<html>
 
   <head>
   </head>
 
<body>
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1"
           Target="_self"
           AdvertisementFile="Ads.xml"
           runat="server"/>
 
   </form>
</body>
 
</html>

Das folgende Beispiel veranschaulicht, wie ein Ereignishandler für das AdCreated-Ereignis erstellt wird, um den Wert der href-Eigenschaft programmgesteuert zu überschreiben.

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

<html>
<head>

   <script runat="server">
   
      Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 

         e.href = "https://www.microsoft.com"   
       
      End Sub      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
      void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
      {

         e.href = "https://www.microsoft.com";   
       
      }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

Das folgende Beispiel veranschaulicht, wie eine XML‑Werbeanzeigedatei formatiert wird.

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

Siehe auch

Referenz

AdRotator

Weitere Ressourcen

Syntax des Webserversteuerelements