Поделиться через

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 Требуется только атрибут.

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

Замечание

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

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

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

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

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

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

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