Sdílet prostřednictvím

AdRotator.AdvertisementFile Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví cestu k souboru XML, který obsahuje informace o inzerování.

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

Hodnota vlastnosti

String

Umístění souboru XML obsahujícího informace o inzerování. Výchozí hodnota je prázdný řetězec ("").

Atributy
BindableAttribute

Příklady

Následující příklad kódu ukazuje, jak použít AdvertisementFile vlastnost k určení umístění souboru XML, který obsahuje informace o inzerování.

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

Následující příklad kódu ukazuje formát souboru inzertního souboru XML.

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

Poznámky

AdvertisementFile Pomocí vlastnosti určete umístění souboru XML, který obsahuje informace o inzerování. Soubor XML se musí nacházet na stejném webu. Pro účely nasazení a zabezpečení důrazně doporučujeme umístit soubor do stejné webové aplikace. K souboru XML, který se nachází v jiné aplikaci na stejném webu, je možné získat přístup pouze v případě, že má aplikace dostatečný vztah důvěryhodnosti.

Tuto vlastnost můžete nastavit buď na absolutní cestu, nebo cestu relativní k souboru XML. Pokud chcete zjednodušit nasazení, použijte relativní cestu. Pokud použijete relativní cestu, je tato cesta relativní vzhledem k umístění stránky nebo uživatelského ovládacího prvku, který obsahuje ovládací AdRotator prvek.

Vlastnost AdvertisementFile je volitelná. Reklamu je také možné v události nastavit programově AdCreated .

Soubor XML obsahuje následující předdefinované atributy. Vyžaduje se ImageUrl pouze atribut .

Atribut Popis
ImageUrl Adresa URL obrázku, který se má zobrazit.
Height Výška obrázku v pixelech (volitelné).
Width Šířka obrázku v pixelech (volitelné).
NavigateUrl Adresa URL stránky, na které se má přejít při kliknutí na AdRotator ovládací prvek
AlternateText Text, který se má zobrazit, pokud obrázek není k dispozici. V některých prohlížečích se tento text zobrazuje jako popis.
Keyword Kategorie pro reklamu. Používá ho AdRotator ovládací prvek k filtrování seznamu reklam pro konkrétní kategorii.
Impressions Hodnota, která určuje, jak často se reklama zobrazuje ve vztahu k jiným reklamám v souboru XML.

Poznámka

Atributy ImageUrl a NavigateUrl můžou být úplná adresa URL, kořenově relativní cesta nebo relativní cesta. Pokud použijete cestu relativní ke kořenovému adresáři, je cesta relativní ke stejnému webu. Pokud použijete relativní cestu, je cesta relativní vzhledem k adresáři, který obsahuje inzertní soubor.

Můžete také zahrnout vlastní atributy pomocí vlastních značek v souboru XML. Všechny značky atributů se analyzují z inzertovaného souboru a hodnoty se umístí do slovníku AdProperties . Slovník můžete použít AdProperties pro programový přístup k vlastním atributům.

Informace v tomto souboru nejsou ověřeny ovládacím AdRotator prvek. Pokud chcete reklamám zabránit ve spouštění škodlivých skriptů, měli byste data před jejich vydáním vždy zkontrolovat nebo přijmout informace o reklamě jenom z důvěryhodných zdrojů.

Chcete-li soubor inzerování zabezpečit před neoprávněným přístupem k internetu, proveďte jednu nebo více z následujících akcí:

  • Uložte ho do adresáře Data, který je nakonfigurovaný v Machine.config tak, aby odepřel přístup k internetu pro soubory libovolného typu.
  • Přejmenujte soubor s příponou, která není .xml, a namapujte příponu na HttpForbiddenHandler v Web.config. Další informace najdete httpHandlers v části Machine.config souboru.

Platí pro

Viz také