AdRotator.AdvertisementFile-Eigenschaft

Artikel
08/20/2007

Ruft den Pfad einer XML-Datei mit Informationen über die Werbung ab oder legt diesen fest.

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

Syntax

'Declaration
<BindableAttribute(True)> _
Public Property AdvertisementFile As String
'Usage
Dim instance As AdRotator
Dim value As String

value = instance.AdvertisementFile

instance.AdvertisementFile = value

[BindableAttribute(true)] 
public string AdvertisementFile { get; set; }

[BindableAttribute(true)] 
public:
property String^ AdvertisementFile {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_AdvertisementFile ()

/** @property */
public void set_AdvertisementFile (String value)

public function get AdvertisementFile () : String

public function set AdvertisementFile (value : String)

Eigenschaftenwert

Der Speicherort einer XML-Datei mit Daten für die Werbung. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Geben Sie mit der AdvertisementFile-Eigenschaft den Speicherort einer XML-Datei an, die Informationen über die Werbung enthält. Die XML-Datei muss in derselben Website gespeichert sein. Im Hinblick auf die Bereitstellung und die Sicherheit wird dringend empfohlen, dass Sie die Datei in derselben Webanwendung speichern. Auf eine XML-Datei, die in einer anderen Anwendung in derselben Site abgelegt ist, kann nur zugegriffen werden, wenn die Anwendung eine ausreichende Vertrauensstellung besitzt.

Sie können für diese Eigenschaft entweder einen absoluten Pfad oder einen Pfad relativ zur XML-Datei festlegen. Mit einem relativen Pfad können Sie die Bereitstellung vereinfachen. Ein relativer Pfad ist relativ zum Speicherort der Seite oder des Benutzersteuerelements mit dem AdRotator-Steuerelement.

Die AdvertisementFile-Eigenschaft ist optional. Eine Werbung kann auch programmgesteuert im AdCreated-Ereignis festgelegt werden.

Die XML-Datei enthält die folgenden vordefinierten Attribute. Nur das ImageUrl-Attribut ist erforderlich.

Attribut	Beschreibung
ImageUrl	Der URL des anzuzeigenden Bilds.
Height	Die Höhe des Bilds in Pixel (optional).
Width	Die Breite des Bilds in Pixel (optional).
href	Der URL der Seite, zu der navigiert werden soll, wenn auf das AdRotator-Steuerelement geklickt wird.
AlternateText	Der Text, der angezeigt werden soll, wenn das Bild nicht verfügbar ist. In einigen Browsern wird dieser Text als QuickInfo angezeigt.
Keyword	Die Kategorie für die Werbung. Damit filtert das AdRotator-Steuerelement die Liste der Werbungen nach einer bestimmten Kategorie.
Impressions	Ein Wert, der angibt, wie oft eine Werbung im Verhältnis zu anderen Werbungen in der XML-Datei angezeigt wird.

Hinweis

Das ImageUrl-Attribut und das href-Attribut können ein vollständiger URL, ein relativer Pfad zum Stamm oder ein relativer Pfad sein. Ein zum Stamm relativer Pfad ist relativ zu derselben Website. Ein relativer Pfad ist relativ zu dem Verzeichnis, das die Datei für die Werbung enthält.

Sie können mit benutzerdefinierten Tags in der XML-Datei auch benutzerdefinierte Attribute einbinden. Alle Attributtags werden aus der Datei für die Werbung analysiert, und die Werte werden im AdProperties-Wörterbuch abgelegt. Mit dem AdProperties-Wörterbuch können Sie programmgesteuert auf die benutzerdefinierten Attribute zugreifen.

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 Daten, das in Machine.config so konfiguriert wurde, dass der Internetzugriff für Dateien aller Typen 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.

Thema	Position
Exemplarische Vorgehensweise: Anzeigen und Nachverfolgen von Werbung mit dem AdRotator-Steuerelement	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
Exemplarische Vorgehensweise: Anzeigen und Nachverfolgen von Werbung mit dem AdRotator-Steuerelement	Erstellen von ASP.NET-Webanwendungen in Visual Studio

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der AdvertisementFile-Eigenschaft der Speicherort der XML-Datei angegeben wird, die Informationen über die Werbung enthält.

<%@ 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 der XML-Datei für die Werbung veranschaulicht.

<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>
    <Caption>This is the caption for Ad#1</Caption> 
  </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>
    <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
</Advertisements>

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-Klasse
AdRotator-Member
System.Web.UI.WebControls-Namespace
AdCreated
AdCreatedEventArgs-Klasse

Weitere Ressourcen

AdRotator-Webserver-Steuerelement

Freigeben über