Språk

AdRotator.AdvertisementFile Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger sökvägen till en XML-fil som innehåller annonsinformation.

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

Egenskapsvärde

String

Platsen för en XML-fil som innehåller annonsinformation. Standardvärdet är en tom sträng ("").

Attribut
BindableAttribute

Exempel

Följande kodexempel visar hur du använder AdvertisementFile egenskapen för att ange platsen för XML-filen som innehåller annonsinformation.

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

I följande kodexempel visas filformatet för XML-annonsfilen.

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

Kommentarer

Använd egenskapen AdvertisementFile för att ange platsen för en XML-fil som innehåller annonsinformation. XML-filen måste finnas på samma webbplats. I distributions- och säkerhetssyfte rekommenderar vi starkt att du placerar filen i samma webbprogram. Det går bara att komma åt en XML-fil som finns i ett annat program på samma plats om programmet har tillräckligt förtroende.

Du kan ange den här egenskapen till antingen en absolut sökväg eller en sökväg i förhållande till XML-filen. Använd en relativ sökväg för att förenkla distributionen. Om du använder en relativ sökväg är den sökvägen relativ till platsen för sidan eller användarkontrollen som innehåller AdRotator kontrollen.

Egenskapen AdvertisementFile är valfri. En annons kan också ställas in programmatiskt i händelsen AdCreated .

XML-filen innehåller följande fördefinierade attribut. ImageUrl Endast attributet krävs.

Attribute Description
ImageUrl URL:en för den bild som ska visas.
Height Bildens höjd i bildpunkter (valfritt).
Width Bildens bredd i bildpunkter (valfritt).
NavigateUrl Url:en för sidan som du vill navigera till när AdRotator kontrollen klickas.
AlternateText Texten som ska visas om bilden inte är tillgänglig. I vissa webbläsare visas den här texten som en knappbeskrivning.
Keyword Kategorin för annonsen. Detta används av AdRotator kontrollen för att filtrera listan över annonser för en specifik kategori.
Impressions Ett värde som anger hur ofta en annons visas i förhållande till andra annonser i XML-filen.

Note

Attributen ImageUrl och NavigateUrl kan vara en fullständig URL, en rotrelativ sökväg eller en relativ sökväg. Om du använder en rotrelativ sökväg är sökvägen relativ till samma webbplats. Om du använder en relativ sökväg är sökvägen relativ till katalogen som innehåller annonsfilen.

Du kan också inkludera anpassade attribut med hjälp av anpassade taggar i XML-filen. Alla attributtaggar parsas från annonsfilen och värdena placeras i AdProperties ordlistan. Du kan använda AdProperties ordlistan för att programmatiskt komma åt dina anpassade attribut.

Informationen i den här filen verifieras inte av AdRotator kontrollen. För att förhindra att annonser kör skadliga skript bör du alltid kontrollera data innan du släpper dem, eller acceptera annonsinformation endast från betrodda källor.

Om du vill skydda din annonsfil från obehörig Internetåtkomst gör du något av följande:

  • Lagra den i datakatalogen, som är konfigurerad i Machine.config för att neka Internetåtkomst för filer av alla typer.
  • Byt namn på filen med ett tillägg som inte är .xmloch mappa tillägget till HttpForbiddenHandler i Web.config. Mer information httpHandlers finns i avsnittet i din Machine.config-fil.

Gäller för

Se även