AdRotator.AdvertisementFile Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Получает или задает путь к XML-файлу, содержащему рекламные сведения.

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

Значение свойства

String

Размещение XML-файла, содержащего рекламные сведения. Значение по умолчанию — пустая строка.

Атрибуты
BindableAttribute

Примеры

В следующем примере кода показано, как использовать AdvertisementFile свойство для указания расположения XML-файла, содержащего сведения об объявлении.

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

В следующем примере кода показан формат файла объявления 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>

Комментарии

Используйте свойство , AdvertisementFile чтобы указать расположение XML-файла, содержащего сведения об объявлении. XML-файл должен находиться на том же веб-сайте. В целях развертывания и безопасности настоятельно рекомендуется разместить файл в том же веб-приложении. Доступ к XML-файлу, расположенному в другом приложении на том же сайте, можно получить только в том случае, если у приложения достаточно доверия.

Для этого свойства можно задать абсолютный путь или путь относительно XML-файла. Используйте относительный путь для упрощения развертывания. Если используется относительный путь, этот путь относится к расположению страницы или пользовательского элемента управления, содержащего элемент AdRotator управления .

Свойство AdvertisementFile необязательное. Объявление также можно задать программным способом в событии AdCreated .

XML-файл содержит следующие предопределенные атрибуты. Требуется ImageUrl только атрибут .

attribute Описание
ImageUrl URL-адрес для отображения изображения.
Height Высота изображения в пикселях (необязательно).
Width Ширина изображения в пикселях (необязательно).
NavigateUrl URL-адрес страницы для перехода при щелчке AdRotator элемента управления.
AlternateText Текст, отображаемый, если изображение недоступно. В некоторых браузерах этот текст отображается в виде подсказки.
Keyword Категория для объявления. Используется элементом AdRotator управления для фильтрации списка объявлений для определенной категории.
Impressions Значение типа , указывающее, как часто отображается объявление относительно других объявлений в XML-файле.

Примечание

Атрибуты ImageUrl и NavigateUrl могут быть полным URL-адресом, корневым или относительным путем. Если вы используете путь относительно корня, путь относится к тому же веб-сайту. Если используется относительный путь, путь будет относительно каталога, содержащего файл объявления.

Вы также можете включить настраиваемые атрибуты с помощью настраиваемых тегов в XML-файл. Все теги атрибутов анализируются из файла объявления, а значения помещаются в словарь AdProperties . Словарь AdProperties можно использовать для программного доступа к пользовательским атрибутам.

Сведения в этом файле не проверяются элементом AdRotator управления . Чтобы рекламные объявления не выполняли вредоносные сценарии, всегда следует проверка данные перед их выпуском или принимать рекламные сведения только из надежных источников.

Чтобы защитить файл объявления от несанкционированного доступа к Интернету, выполните одно или несколько из следующих действий.

  • Сохраните его в каталоге Data, который настроен в Machine.config, чтобы запретить доступ к Интернету для файлов любого типа.
  • Переименуйте файл с расширением, которое не .xml, и сопоставьте расширение с HttpForbiddenHandler в Web.config. Дополнительные сведения см. в httpHandlers разделе файла Machine.config.

Применяется к

См. также раздел