AdRotator.AdvertisementFile Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

public:
 property System::String ^ AdvertisementFile { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string AdvertisementFile { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.AdvertisementFile : string with get, set
Public Property AdvertisementFile As String

Eigenschaftswert

String

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

Attribute
BindableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AdvertisementFile -Eigenschaft verwendet wird, um den Speicherort der XML-Datei anzugeben, die Ankündigungsinformationen enthält.

<%@ 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>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </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>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

Das folgende Codebeispiel zeigt das Dateiformat der XML-Ankündigungsdatei.

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/image1.jpg</ImageUrl>  
    <Height>60</Height>  
    <Width>190</Width>  
    <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>~/Images/image2.jpg</ImageUrl>  
    <Height>90</Height>  
    <Width>90</Width>  
    <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 die AdvertisementFile -Eigenschaft, um den Speicherort einer XML-Datei anzugeben, die Ankündigungsinformationen enthält. Die XML-Datei muss sich auf derselben Website befinden. Aus Bereitstellungs- und Sicherheitsgründen wird dringend empfohlen, die Datei in derselben Webanwendung zu platzieren. Es ist nur möglich, auf eine XML-Datei zuzugreifen, die sich in einer anderen Anwendung auf demselben Standort befindet, wenn die Anwendung über eine ausreichende Vertrauensstellung verfügt.

Sie können diese Eigenschaft entweder auf einen absoluten Pfad oder einen Pfad relativ zur XML-Datei festlegen. Verwenden Sie einen relativen Pfad, um die Bereitstellung zu vereinfachen. Wenn Sie einen relativen Pfad verwenden, ist dieser Pfad relativ zum Speicherort der Seite oder des Benutzersteuerelements, das das AdRotator Steuerelement enthält.

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

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

attribute BESCHREIBUNG
ImageUrl Die URL des anzuzeigenden Bilds.
Height Die Höhe des Bilds in Pixel (optional).
Width Die Breite des Bilds in Pixel (optional).
NavigateUrl Die 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. Dies wird vom AdRotator Steuerelement verwendet, um die Liste der Anzeigen für eine bestimmte Kategorie zu filtern.
Impressions Ein Wert, der angibt, wie oft eine Ankündigung im Verhältnis zu anderen Ankündigungen in der XML-Datei angezeigt wird.

Hinweis

Die ImageUrl Attribute und NavigateUrl können eine vollständige URL, ein stammrelativer Pfad oder ein relativer Pfad sein. Wenn Sie einen relativen Stammpfad verwenden, ist der Pfad relativ zur gleichen Website. Wenn Sie einen relativen Pfad verwenden, ist der Pfad relativ zum Verzeichnis, das die Ankündigungsdatei enthält.

Sie können auch benutzerdefinierte Attribute einschließen, indem Sie benutzerdefinierte Tags in die XML-Datei verwenden. Alle Attributtags werden aus der Ankündigungsdatei analysiert, und die Werte werden im AdProperties Wörterbuch platziert. Sie können das AdProperties Wörterbuch verwenden, um programmgesteuert auf Ihre benutzerdefinierten Attribute zuzugreifen.

Die Informationen in dieser Datei werden vom AdRotator Steuerelement nicht überprüft. Um zu verhindern, dass Anzeigen böswillige Skripts ausführen, sollten Sie die Daten immer überprüfen, bevor Sie sie veröffentlichen, oder Anzeigeninformationen nur von vertrauenswürdigen Quellen akzeptieren.

Führen Sie eine oder mehrere der folgenden Schritte aus, um Ihre Werbedatei vor nicht autorisiertem Internetzugriff zu schützen:

  • Speichern Sie es im Verzeichnis Daten, das in Machine.config konfiguriert ist, um den Internetzugriff für Dateien beliebiger Art zu verweigern.
  • Benennen Sie die Datei mit einer Erweiterung um, die nicht .xml ist, und ordnen Sie die Erweiterung in Web.config zu HttpForbiddenHandler . Weitere Informationen finden Sie im httpHandlers Abschnitt ihrer Machine.config-Datei.

Gilt für:

Weitere Informationen