AdRotator.AdvertisementFile Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ścieżkę do pliku XML zawierającego informacje o anonsowaniu.

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

Wartość właściwości

String

Lokalizacja pliku XML zawierającego informacje o anonsie. Wartością domyślną jest ciąg pusty ("").

Atrybuty
BindableAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą AdvertisementFile właściwości określić lokalizację pliku XML zawierającego informacje o anonsowaniu.

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

Poniższy przykład kodu przedstawia format pliku anonsowania 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>

Uwagi

AdvertisementFile Użyj właściwości , aby określić lokalizację pliku XML zawierającego informacje o anonsowaniu. Plik XML musi znajdować się w tej samej witrynie sieci Web. W celach związanych z wdrażaniem i zabezpieczeniami zdecydowanie zaleca się umieszczenie pliku w tej samej aplikacji sieci Web. Dostęp do pliku XML znajdującego się w innej aplikacji w tej samej witrynie jest możliwy tylko wtedy, gdy aplikacja ma wystarczającą relację zaufania.

Tę właściwość można ustawić na ścieżkę bezwzględną lub ścieżkę względną względem pliku XML. Użyj ścieżki względnej, aby uprościć wdrażanie. Jeśli używasz ścieżki względnej, ta ścieżka jest względna względem lokalizacji strony lub kontrolki użytkownika zawierającej kontrolkę AdRotator .

Właściwość jest opcjonalna AdvertisementFile . Anons może być również ustawiany programowo w AdCreated zdarzeniu.

Plik XML zawiera następujące wstępnie zdefiniowane atrybuty. ImageUrl Wymagany jest tylko atrybut .

Atrybut Opis
ImageUrl Adres URL obrazu do wyświetlenia.
Height Wysokość obrazu w pikselach (opcjonalnie).
Width Szerokość obrazu w pikselach (opcjonalnie).
NavigateUrl Adres URL strony, do których ma przejść po kliknięciu kontrolki AdRotator .
AlternateText Tekst do wyświetlenia, jeśli obraz jest niedostępny. W niektórych przeglądarkach ten tekst jest wyświetlany jako etykietka narzędzia.
Keyword Kategoria anonsu. Jest to używane przez kontrolkę AdRotator do filtrowania listy anonsów dla określonej kategorii.
Impressions Wartość wskazująca, jak często anons jest wyświetlany w odniesieniu do innych anonsów w pliku XML.

Uwaga

Atrybuty ImageUrl i NavigateUrl mogą być pełnym adresem URL, ścieżką względną katalogu głównego lub ścieżką względną. Jeśli używasz ścieżki względnej katalogu głównego, ścieżka jest względna względem tej samej witryny sieci Web. Jeśli używasz ścieżki względnej, ścieżka jest względna względem katalogu zawierającego plik anonsowania.

Atrybuty niestandardowe można również uwzględnić przy użyciu tagów niestandardowych w pliku XML. Wszystkie tagi atrybutów są analizowane z pliku anonsu, a wartości są umieszczane w słowniku AdProperties . Słownik umożliwia AdProperties programowy dostęp do atrybutów niestandardowych.

Informacje w tym pliku nie są weryfikowane przez kontrolkę AdRotator . Aby zapobiec wykonywaniu złośliwych skryptów przez reklamy, należy zawsze sprawdzać dane przed ich opublikowaniem lub akceptować informacje o reklamach tylko z zaufanych źródeł.

Aby zabezpieczyć plik anonsu przed nieautoryzowanym dostępem do Internetu, wykonaj co najmniej jedną z następujących czynności:

  • Zapisz go w katalogu Data, który jest skonfigurowany w Machine.config, aby uniemożliwić dostęp do Internetu dla plików dowolnego typu.
  • Zmień nazwę pliku na rozszerzenie, które nie jest .xml, i zamapuj rozszerzenie na HttpForbiddenHandler w Web.config. Aby uzyskać więcej informacji, zobacz sekcję httpHandlers w pliku Machine.config.

Dotyczy

Zobacz też