Sdílet prostřednictvím

AdRotator.AdvertisementFile Vlastnost

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 inzerovaném programu. 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 inzerování 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. Přístup k souboru XML, který je umístěn v jiné aplikaci na stejném webu, je možné pouze v případě, že aplikace má dostatečný vztah důvěryhodnosti.

Tuto vlastnost můžete nastavit buď na absolutní cestu, nebo cestu vzhledem k souboru XML. Ke zjednodušení 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ý ovládací prvek obsahuje AdRotator .

Vlastnost AdvertisementFile je nepovinná. V události lze také nastavit AdCreated inzerci prostřednictvím kódu programu.

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

Vlastnost Description
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é přejdete po 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 zobrazí jako popis.
Keyword Kategorie pro reklamu. Tento postup používá AdRotator ovládací prvek k filtrování seznamu reklam pro určitou kategorii.
Impressions Hodnota, která označuje, jak často se reklamy zobrazují ve vztahu k jiným reklamám v souboru XML.

Poznámka:

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

Vlastní atributy můžete zahrnout také pomocí vlastních značek v souboru XML. Všechny značky atributů se analyzují ze souboru inzerování a hodnoty se umístí do slovníku AdProperties . Pomocí slovníku AdProperties můžete programově přistupovat k vlastním atributům.

Ovládací prvek neověřuje AdRotator informace v tomto souboru. Abyste zabránili reklamám ve spouštění škodlivých skriptů, měli byste data před vydáním vždy zkontrolovat nebo přijmout informace o reklamách pouze z důvěryhodných zdrojů.

Chcete-li zabezpečit soubor inzerování 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 datového adresáře, 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 Web.config. Další informace najdete httpHandlers v části v souboru Machine.config.

Platí pro

Viz také