Freigeben über


AdRotator-Klasse

Zeigt ein Werbebanner auf einer Webseite an.

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

Syntax

'Declaration
Public Class AdRotator
    Inherits DataBoundControl
'Usage
Dim instance As AdRotator
public class AdRotator : DataBoundControl
public ref class AdRotator : public DataBoundControl
public class AdRotator extends DataBoundControl
public class AdRotator extends DataBoundControl

Hinweise

Verwenden Sie das AdRotator-Steuerelement, um auf der Webseite ein nach dem Zufallsprinzip ausgewähltes Werbebanner anzuzeigen. Die angezeigte Werbung ändert sich bei jeder Aktualisierung der Seite.

Informationen über die Werbung werden in einer separaten XML-Datei gespeichert. Mit der XML-Datei können Sie eine Liste von Werbungen mit den dazugehörenden Attributen verwalten. Attribute enthalten den Pfad zu einem anzuzeigenden Bild, den URL, der beim Klicken auf ein Steuerelement aufgerufen wird, den alternativen Text, der angezeigt wird, wenn das Bild nicht verfügbar ist, ein Schlüsselwort und Angaben zur Frequenz der Werbung. Informationen in dieser Datei werden vom AdRotator-Steuerelement nicht validiert. Damit keine böswilligen Skripts von der Werbung ausgeführt werden, sollten Sie vor einer Freigabe die Daten stets überprüfen oder Informationen über die Werbung nur von vertrauenswürdigen Quellen akzeptieren.

Sie können die Datei für die Werbung vor nicht autorisiertem Internetzugriff zu schützen, indem Sie eine oder mehrere der folgenden Aktionen ausführen:

  • Speichern Sie die Datei im Verzeichnis App_Data, das so konfiguriert ist, dass der Internetzugriff für Dateien jeden Typs verweigert wird.

  • Benennen Sie die Datei so um, dass sie nicht mehr die Erweiterung XML trägt, und weisen Sie die Erweiterung dem HttpForbiddenHandler in Web.config zu. Weitere Informationen finden Sie im Abschnitt httpHandlers-Element (ASP.NET-Einstellungsschema) in der Datei Machine.config.

Als alternative Datenquelle zu einer XML-Datei können Informationen über die Werbung durch ein Rückrufereignis bereitgestellt werden. Dieses Ereignis kann auch mit einer XML-Datei kombiniert werden, um das Verhalten des AdRotator-Steuerelements zu erweitern, sodass z. B. eine Umleitung zu einer anderen Seite erfolgt. Weitere Informationen über das Dateiformat finden Sie unter der AdvertisementFile-Eigenschaft.

Jeder Werbung kann ein Impressions-Attribut zugewiesen werden. Dieses steuert, wie oft eine Werbung im Verhältnis zu den anderen Werbungen in der Datei für die Werbung ausgewählt wird.

Hinweis

Wenn die Seitenzwischenspeicherung aktiviert ist, wird ein AdRotator-Steuerelement nicht zwischengespeichert. Bei jeder Aktualisierung der Webseite wird eine neue Werbung ausgewählt. Wenn Sie einen Ereignishandler für das AdCreated-Ereignis bereitstellen, wird keine neue Werbung ausgewählt.

Thema Position
Exemplarische Vorgehensweise: Anzeigen und Nachverfolgen von Werbung mit dem AdRotator-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Darstellen von Anzeigen aus einer XML-Datei mithilfe des AdRotator-Webserversteuerelements Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Darstellen von Anzeigen aus einer Datenbank mithilfe des AdRotator-Webserversteuerelements Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen und Nachverfolgen von Werbung mit dem AdRotator-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Auswählen von Anzeigen in einem AdRotator-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Darstellen von Anzeigen aus einer XML-Datei mithilfe des AdRotator-Webserversteuerelements Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Darstellen von Anzeigen aus einer Datenbank mithilfe des AdRotator-Webserversteuerelements Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen und Nachverfolgen von Werbung mit dem AdRotator-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Auswählen von Anzeigen in einem AdRotator-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Darstellen von Anzeigen aus einer XML-Datei mithilfe des AdRotator-Webserversteuerelements Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Darstellen von Anzeigen aus einer Datenbank mithilfe des AdRotator-Webserversteuerelements Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Auswählen von Anzeigen in einem AdRotator-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit dem AdRotator-Steuerelement ein Werbebanner auf einer Webseite angezeigt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
 
 <head>
 </head>
 
 <body>
    <form runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 
 <head>
 </head>
 
 <body>
    <form runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
 
 <head>
 </head>
 
 <body>
    <form runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

Im folgenden Codebeispiel wird das Dateiformat einer XML-Datei veranschaulicht, die die Informationen über die Werbung für das vorherige Beispiel enthält. Weitere Informationen über das Dateiformat finden Sie unter dem AdvertisementFile-Member.

<Advertisements>
  <Ad>
    <ImageUrl>~/Images/image1.jpg</ImageUrl>
    <height>60</height>
    <width>190</width>
    <href>https://www.microsoft.com</href>
    <AlternateText>Microsoft Main Site</AlternateText>
    <Impressions>80</Impressions>
    <Keyword>Topic1</Keyword>
  </Ad>
  <Ad>
    <ImageUrl>~/Images/image2.jpg</ImageUrl>
    <height>90</height>
    <width>90</width>
    <href>http://www.wingtiptoys.com</href>
    <AlternateText>Wingtip Toys</AlternateText>
    <Impressions>80</Impressions>
    <Keyword>Topic2</Keyword>
  </Ad>
</Advertisements>

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.BaseDataBoundControl
         System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.AdRotator

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

AdRotator-Member
System.Web.UI.WebControls-Namespace
AdCreatedEventArgs-Klasse
AdCreatedEventHandler-Delegat
AdvertisementFile

Weitere Ressourcen

AdRotator-Webserver-Steuerelement