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.
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
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand. Berechtigungswert: Minimal.
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand. Berechtigungswert: Minimal.
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