AdRotator.AdvertisementFile AdRotator.AdvertisementFile AdRotator.AdvertisementFile AdRotator.AdvertisementFile Property

Definition

Ruft den Pfad einer XML-Datei mit Informationen über die Werbung ab oder legt diesen fest.Gets or sets the path to an XML file that contains advertisement information.

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

Eigenschaftswert

Der Speicherort einer XML-Datei mit Daten für die Werbung.The location of an XML file containing advertisement information. Der Standardwert ist eine leere Zeichenfolge („“).The default value is an empty string ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AdvertisementFile -Eigenschaft verwendet wird, um den Speicherort der XML-Datei anzugeben, die Ankündigungs Informationen enthält.The following code example demonstrates how to use the AdvertisementFile property to specify the location of the XML file that contains advertisement information.

<%@ 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ündigungs Datei.The following code example shows the file format of the XML advertisement file.

<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 AdvertisementFile die-Eigenschaft, um den Speicherort einer XML-Datei anzugeben, die Ankündigungs Informationen enthält.Use the AdvertisementFile property to specify the location of an XML file that contains advertisement information. Die XML-Datei muss sich in derselben Website befinden.The XML file must reside within the same Web site. Für Bereitstellungs-und Sicherheitszwecke wird dringend empfohlen, dass Sie die Datei in derselben Webanwendung platzieren.For deployment and security purposes, it is strongly recommended that you place the file in the same Web application. Der Zugriff auf eine XML-Datei, die sich in einer anderen Anwendung auf derselben Website befindet, ist nur möglich, wenn die Anwendung über ausreichende Vertrauenswürdigkeit verfügt.It is only possible to access an XML file that is located in a different application on the same site if the application has sufficient trust.

Sie können diese Eigenschaft entweder auf einen absoluten Pfad oder einen Pfad relativ zur XML-Datei festlegen.You can set this property to either an absolute path or a path relative to the XML file. Verwenden Sie einen relativen Pfad zur Vereinfachung der Bereitstellung.Use a relative path to simplify deployment. Wenn Sie einen relativen Pfad verwenden, ist dieser Pfad relativ zum Speicherort der Seite oder des Benutzer Steuer Elements, das AdRotator das Steuerelement enthält.If you use a relative path, that path is relative to the location of the page or user control that contains the AdRotator control.

Die AdvertisementFile -Eigenschaft ist optional.The AdvertisementFile property is optional. Eine Ankündigung kann im AdCreated Ereignis auch Programm gesteuert festgelegt werden.An advertisement can also be programmatically set in the AdCreated event.

Die XML-Datei enthält die folgenden vordefinierten Attribute.The XML file contains the following predefined attributes. Nur das ImageUrl -Attribut ist erforderlich.Only the ImageUrl attribute is required.

AttributAttribute BeschreibungDescription
ImageUrl Die URL des anzuzeigenden Bildes.The URL of the image to display.
Height Die Höhe des Bilds in Pixel (optional).The height of the image, in pixels (optional).
Width Die Breite des Bilds in Pixel (optional).The width of the image, in pixels (optional).
NavigateUrl Die URL der Seite, zu der navigiert werden AdRotator soll, wenn auf das Steuerelement geklickt wird.The URL of the page to navigate to when the AdRotator control is clicked.
AlternateText Der Text, der angezeigt werden soll, wenn das Bild nicht verfügbar ist.The text to display if the image is unavailable. In einigen Browsern wird dieser Text als QuickInfo angezeigt.On some browsers, this text is displayed as a ToolTip.
Keyword Die Kategorie für die Ankündigung.The category for the advertisement. Diese wird vom AdRotator -Steuerelement verwendet, um die Liste der Ankündigungen für eine bestimmte Kategorie zu filtern.This is used by the AdRotator control to filter the list of advertisements for a specific category.
Impressions Ein Wert, der angibt, wie oft eine Ankündigung in Bezug auf andere Ankündigungen in der XML-Datei angezeigt wird.A value that indicates how often an advertisement is displayed in relation to other advertisements in the XML file.

Hinweis

Das ImageUrl - NavigateUrl Attribut und das-Attribut können eine vollständige URL, ein relativer Pfad Pfad oder ein relativer Pfad sein.The ImageUrl and NavigateUrl attributes can be a full URL, a root-relative path, or a relative path. Wenn Sie einen Stamm relativen Pfad verwenden, ist der Pfad relativ zur gleichen Website.If you use a root-relative path, the path is relative to the same Web site. Wenn Sie einen relativen Pfad verwenden, ist der Pfad relativ zu dem Verzeichnis, das die Ankündigungs Datei enthält.If you use a relative path, the path is relative to the directory that contains the advertisement file.

Sie können auch benutzerdefinierte Attribute einschließen, indem Sie benutzerdefinierte Tags in der XML-Datei verwenden.You can also include custom attributes by using custom tags in the XML file. Alle Attribut Tags werden aus der Ankündigungs Datei analysiert, und die Werte werden im AdProperties Wörterbuch abgelegt.All attribute tags are parsed from the advertisement file, and the values are placed in the AdProperties dictionary. Sie können das AdProperties Wörterbuch zum programmgesteuerten Zugriff auf die benutzerdefinierten Attribute verwenden.You can use the AdProperties dictionary to programmatically access your custom attributes.

Die AdRotator Informationen in dieser Datei werden nicht vom Steuerelement überprüft.Information in this file is not validated by the AdRotator control. Wenn Sie verhindern möchten, dass anzeigen böswillige Skripts ausführen, sollten Sie die Daten vor der Freigabe immer überprüfen oder die AD-Informationen nur von vertrauenswürdigen Quellen akzeptieren.To prevent ads from executing malicious scripts, you should always check the data before releasing it, or accept ad information only from trusted sources.

Führen Sie eine oder mehrere der folgenden Aktionen aus, um Ihre Ankündigungs Datei vor nicht autorisiertem Internet Zugriff zu schützen:To secure your advertisement file from unauthorized Internet access, do one or more of the following:

  • Speichern Sie Sie im Datenverzeichnis, das in Machine. config konfiguriert ist, um den Internet Zugriff für Dateien eines beliebigen Typs abzulehnen.Store it in the Data directory, which is configured in Machine.config to deny Internet access for files of any type.

  • Benennen Sie die Datei mit einer Erweiterung um, die keine XML-Datei ist, und HttpForbiddenHandler ordnen Sie die Erweiterung in "Web. config" zu. Weitere Informationen finden Sie im Abschnitt in der Datei "Machine. config".Rename the file with an extension that is not .xml, and map the extension to HttpForbiddenHandler in Web.config. For more information, see the section in your Machine.config file.

Gilt für:

Siehe auch