AdRotator.AdvertisementFile 属性

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置包含公布信息的 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 文件必须位于同一网站中。出于部署和安全目的，强烈建议将文件放在同一 Web 应用程序中。仅当应用程序具有足够的信任时，才能访问位于同一站点上不同应用程序中的 XML 文件。

可以将此属性设置为绝对路径或相对于 XML 文件的路径。使用相对路径来简化部署。如果使用相对路径，则该路径相对于包含 AdRotator 该控件的页面或用户控件的位置。

AdvertisementFile 属性为可选。也可以在事件中 AdCreated 以编程方式设置播发。

XML 文件包含以下预定义属性。 ImageUrl只有属性是必需的。

Attribute	说明
`ImageUrl`	要显示的图像的 URL。
`Height`	图像的高度（以像素为单位） (可选) 。
`Width`	图像的宽度（以像素为单位 (可选) ）。
`NavigateUrl`	单击控件时 AdRotator 要导航到的页面的 URL。
`AlternateText`	图像不可用时要显示的文本。在某些浏览器中，此文本显示为工具提示。
`Keyword`	播发的类别。控件使用此 AdRotator 控件来筛选特定类别的广告列表。
`Impressions`	一个值，该值指示播发相对于 XML 文件中其他播发的显示频率。

备注

ImageUrl和 NavigateUrl 属性可以是完整 URL、根相对路径或相对路径。如果使用根相对路径，则路径相对于同一网站。如果使用相对路径，则路径相对于包含播发文件的目录。

还可以通过在 XML 文件中使用自定义标记来包括自定义属性。所有属性标记都从播发文件进行分析，值放置在字典中 AdProperties 。可以使用 AdProperties 字典以编程方式访问自定义属性。

此文件中的信息不会由 AdRotator 控件验证。若要防止广告执行恶意脚本，应始终在发布数据之前检查数据，或仅接受来自受信任来源的广告信息。

若要保护广告文件免受未经授权的 Internet 访问，请执行以下一项或多项操作：

将其存储在 Data 目录中，该目录在 Machine.config 中配置为拒绝对任何类型的文件进行 Internet 访问。
使用未.xml扩展名重命名文件，并在 Web.config 中将该扩展名 HttpForbiddenHandler 映射到。有关详细信息，请参阅 httpHandlers Machine.config 文件中的部分。

适用于

通过

AdRotator.AdvertisementFile 属性

定义

属性值

示例

注解

适用于

另请参阅

其他资源