AdRotator.AdvertisementFile Eigenschap

Definitie

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

Hiermee wordt het pad opgehaald of ingesteld op een XML-bestand dat advertentiegegevens bevat.

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

Waarde van eigenschap

String

De locatie van een XML-bestand met advertentiegegevens. De standaardwaarde is een lege tekenreeks ("").

Kenmerken
BindableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AdvertisementFile eigenschap gebruikt om de locatie op te geven van het XML-bestand dat advertentiegegevens bevat.

<%@ 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>

In het volgende codevoorbeeld ziet u de bestandsindeling van het XML-advertentiebestand.

<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>

Opmerkingen

Gebruik de AdvertisementFile eigenschap om de locatie op te geven van een XML-bestand dat advertentiegegevens bevat. Het XML-bestand moet zich op dezelfde website bevinden. Voor implementatie- en beveiligingsdoeleinden wordt het sterk aanbevolen dat u het bestand in dezelfde webtoepassing plaatst. Het is alleen mogelijk om toegang te krijgen tot een XML-bestand dat zich in een andere toepassing op dezelfde site bevindt als de toepassing voldoende vertrouwen heeft.

U kunt deze eigenschap instellen op een absoluut pad of een pad ten opzichte van het XML-bestand. Gebruik een relatief pad om de implementatie te vereenvoudigen. Als u een relatief pad gebruikt, is dat pad relatief ten opzichte van de locatie van het pagina- of gebruikersbeheer dat het AdRotator besturingselement bevat.

De AdvertisementFile eigenschap is optioneel. Een advertentie kan ook programmatisch worden ingesteld in het AdCreated evenement.

Het XML-bestand bevat de volgende vooraf gedefinieerde kenmerken. Alleen het ImageUrl kenmerk is vereist.

Attribute Description
ImageUrl De URL van de afbeelding die moet worden weergegeven.
Height De hoogte van de afbeelding, in pixels (optioneel).
Width De breedte van de afbeelding, in pixels (optioneel).
NavigateUrl De URL van de pagina waarnaar u wilt navigeren wanneer op het AdRotator besturingselement wordt geklikt.
AlternateText De tekst die moet worden weergegeven als de afbeelding niet beschikbaar is. In sommige browsers wordt deze tekst weergegeven als knopinfo.
Keyword De categorie voor de advertentie. Dit wordt gebruikt door het AdRotator besturingselement om de lijst met advertenties voor een specifieke categorie te filteren.
Impressions Een waarde die aangeeft hoe vaak een advertentie wordt weergegeven in relatie tot andere advertenties in het XML-bestand.

Note

De ImageUrl en NavigateUrl kenmerken kunnen een volledige URL, een hoofd-relatief pad of een relatief pad zijn. Als u een hoofd-relatief pad gebruikt, is het pad relatief ten opzichte van dezelfde website. Als u een relatief pad gebruikt, is het pad relatief ten opzichte van de map die het advertentiebestand bevat.

U kunt ook aangepaste kenmerken opnemen met behulp van aangepaste tags in het XML-bestand. Alle kenmerktags worden geparseerd uit het advertentiebestand en de waarden worden in de AdProperties woordenlijst geplaatst. U kunt de AdProperties woordenlijst gebruiken om programmatisch toegang te krijgen tot uw aangepaste kenmerken.

Informatie in dit bestand wordt niet gevalideerd door het AdRotator besturingselement. Als u wilt voorkomen dat advertenties schadelijke scripts uitvoeren, moet u altijd de gegevens controleren voordat ze worden vrijgegeven of advertentiegegevens alleen accepteren uit vertrouwde bronnen.

Ga op een of meer van de volgende manieren te werk om uw advertentiebestand te beveiligen tegen onbevoegde internettoegang:

  • Sla deze op in de map Gegevens, die is geconfigureerd in Machine.config om internettoegang voor bestanden van elk type te weigeren.
  • Wijzig de naam van het bestand met een extensie die niet .xmlen wijs de extensie HttpForbiddenHandler toe aan in Web.config. Zie de httpHandlers sectie in uw Machine.config-bestand voor meer informatie.

Van toepassing op

Zie ook