AdRotator 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在网页上显示广告横幅。
public ref class AdRotator : System::Web::UI::WebControls::WebControlpublic ref class AdRotator : System::Web::UI::WebControls::DataBoundControlpublic class AdRotator : System.Web.UI.WebControls.WebControlpublic class AdRotator : System.Web.UI.WebControls.DataBoundControltype AdRotator = class
inherit WebControltype AdRotator = class
inherit DataBoundControlPublic Class AdRotator
Inherits WebControlPublic Class AdRotator
Inherits DataBoundControl- 继承
- 继承
示例
下面的代码示例演示如何使用 AdRotator 控件在网页上显示广告横幅。
<%@ 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 文件的文件格式。 有关文件格式的详细信息，请参阅 成员 AdvertisementFile 。
<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>
</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>
</Ad>
</Advertisements>
注解
本主题内容：
介绍
AdRotator使用 控件在网页上显示随机选择的广告横幅。 每当页面刷新时，显示的播发会更改。
播发信息存储在单独的 XML 文件中。 XML 文件允许你维护播发列表及其关联属性。 属性包括要显示的图像的路径、单击控件时要链接到的 URL、图像不可用时要显示的备用文本、关键字 (keyword) 以及播发频率。 此文件中的信息不会由 AdRotator 控件验证。 若要防止广告执行恶意脚本，应始终在发布数据之前检查数据，或仅接受来自受信任来源的广告信息。
若要保护广告文件免受未经授权的 Internet 访问，请执行以下一项或多项操作：
- 将其存储在 App_Data 目录中，该目录配置为拒绝对任何类型的文件进行 Internet 访问。
- 重命名扩展名不是.xml的文件，并将扩展名
HttpForbiddenHandler映射到 Web.config 中的 。有关详细信息，请参阅httpHandlersMachine.config 文件中的 部分。
作为 XML 文件作为数据源的替代方法，可以通过回调事件提供播发信息。 此事件还可以与 XML 文件结合使用，以扩展控件的行为 AdRotator ，例如重定向到另一页。 有关文件格式的其他信息， AdvertisementFile 请参阅 属性。
XML 播发文件格式
控件 AdRotator 使用单独的 XML 播发文件来存储播发信息，例如要显示的图像的位置和要链接到的页面的 URL。 控件 AdvertisementFile 的 AdRotator 属性指定此文件的路径。
创建播发文件时，打开和结束 <Advertisements> 标记分别标记文件的开头和结尾。 开始和结束 <Ad> 标记分隔每个播发。 所有播发都嵌套在开始标记和结束 <Advertisements> 标记之间。 如果文件包含多个<Advertisements>标记，则控件将仅分析AdRotator文件中的第一组<Advertisements>标记。 将忽略所有其他 <Advertisements> 标记。
每个播发的数据元素嵌套在开始标记和结束 <Ad> 标记之间。 尽管某些数据元素是预定义 (（如 ImageUrl 和 NavigateUrl) ），但可以在标记之间 <Ad> 放置自定义元素。 控件在分析文件时将读取 AdRotator 这些元素。 然后，该信息将 AdCreated 传递到字典属性中的 AdProperties 事件。
下表列出了为 XML 播发文件预定义的数据元素。
| 元素 | 说明 |
|---|---|
ImageUrl |
图像文件的绝对 URL 或相对 URL (可选) 。 |
NavigateUrl |
如果用户单击广告 (可选) ，则链接到的页面 URL。
注意： 如果未设置此元素，则 HRef 属性不会呈现在定位点标记上。 |
Height |
图像的高度（以像素为单位） (可选) 。 |
Width |
图像的宽度（以像素为单位） (可选) 。 |
AlternateText |
当 属性指定的 ImageUrl 图像不可用 (可选) 时，将显示文本来代替图像。 在某些浏览器中，此文本也显示为 ToolTip 播发的 。 |
Keyword |
播发 (的类别，例如“计算机”) ，可按 (可选) 进行筛选。 |
Impressions |
指示轮换计划中广告相对于文件中其他广告的重要性的数字 (可选) 。 数字越大，广告的显示频率就越高。 XML 文件中所有 <Impressions> 值的总数不能超过 2，047，999，999。 如果存在，控件将 AdRotator 引发运行时异常。 |
以下示例显示了 XML 播发文件的格式。
<Advertisements>
<Ad>
<ImageUrl>
URL of image to display for Advertisement #1
</ImageUrl>
<NavigateUrl>
URL of page to link to for Advertisement #1
</NavigateUrl>
<AlternateText>
Text to show as a ToolTip for Advertisement #1
</AlternateText>
<Keyword>
Keyword used to filter for Advertisement #1
</Keyword>
<Impressions>
Relative importance of Advertisement #1
</Impressions>
<CustomInformation>
Custom Data about Advertisement #1
</CustomInformation>
</Ad>
</Advertisements>
声明性语法
<asp:AdRotator
AccessKey="string"
AdvertisementFile="uri"
AlternateTextField="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ImageUrlField="string"
KeywordFilter="string"
NavigateUrlField="string"
OnAdCreated="AdCreated event handler"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Target="string|_blank|_parent|_search|_self|_top"
ToolTip="string"
Visible="True|False"
Width="size"
/>
构造函数
| AdRotator() |
初始化 AdRotator 类的新实例。 |
属性
| AccessKey |
获取或设置使您得以快速导航到 Web 服务器控件的访问键。 (继承自 WebControl) |
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AdvertisementFile |
获取或设置包含公布信息的 XML 文件的路径。 |
| AlternateTextField |
获取或设置一个自定义数据字段，使用它代替广告的 |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取与控件的特性不对应的任意特性（只用于呈现）的集合。 (继承自 WebControl) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取 ControlCollection 对象，该对象表示 UI 层次结构中的指定服务器控件的子控件。 (继承自 Control) |
| ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| ControlStyleCreated |
获取一个值，该值指示是否已为 Style 属性创建了 ControlStyle 对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| CssClass |
获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DataMember |
当数据源包含多个不同的数据项列表时，获取或设置数据绑定控件绑定到的数据列表的名称。 (继承自 DataBoundControl) |
| DataSource |
获取或设置对象，数据绑定控件从该对象中检索其数据项列表。 (继承自 BaseDataBoundControl) |
| DataSourceID |
获取或设置控件的 ID，数据绑定控件从该控件中检索其数据项列表。 (继承自 DataBoundControl) |
| DataSourceObject |
获取一个对象，该对象实现 IDataSource 接口，以便提供对该对象的数据内容的访问。 (继承自 DataBoundControl) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| Enabled |
获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| Font |
获取与广告横幅控件关联的字体属性。 |
| ForeColor |
获取或设置 Web 服务器控件的前景色（通常是文本颜色）。 (继承自 WebControl) |
| HasAttributes |
获取一个值，该值指示控件是否具有特性集。 (继承自 WebControl) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| ImageUrlField |
获取或设置一个自定义数据字段，使用它代替广告的 |
| Initialized |
获取一个值，该值指示数据绑定控件是否已经初始化。 (继承自 BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
获取指示是否设置 DataSourceID 属性的值。 (继承自 BaseDataBoundControl) |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsDataBindingAutomatic |
获取一个值，该值指示数据绑定是否自动进行。 (继承自 BaseDataBoundControl) |
| IsEnabled |
获取一个值，该值指示是否启用控件。 (继承自 WebControl) |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsUsingModelBinders |
获取一个值，该值指示是否使用模型绑定。 (继承自 DataBoundControl) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| ItemType |
获取或设置强类型化数据绑定的数据项目类型的名称。 (继承自 DataBoundControl) |
| KeywordFilter |
获取或设置类别关键字以筛选出 XML 公布文件中特定类型的公布。 |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| NavigateUrlField |
获取或设置一个自定义数据字段，使用它代替广告的 |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| RequiresDataBinding |
获取或设置一个值，该值指示是否应调用 DataBind() 方法。 (继承自 BaseDataBoundControl) |
| SelectArguments |
获取数据绑定控件从数据源控件检索数据时使用的 DataSourceSelectArguments 对象。 (继承自 DataBoundControl) |
| SelectMethod |
为了读取数据要调用的方法的名称。 (继承自 DataBoundControl) |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 WebControl) |
| Style |
获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。 (继承自 WebControl) |
| SupportsDisabledAttribute |
获取一个值，该值指示在控件的 |
| SupportsDisabledAttribute |
获取一个值，该值指示在控件的 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TagKey |
获取 AdRotator 控件的 HTML 标记。 |
| TagKey |
获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| Target |
获取或设置当单击 AdRotator 控件时，显示所链接到的网页的内容的浏览器窗口或框架的名称。 |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| ToolTip |
获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取 AdRotator 控件在层次结构中的唯一限定标识符。 |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上。 (继承自 Control) |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
方法
事件
| AdCreated |
在控件创建后、呈现页面前，在每个到服务器的往返行程过程中发生一次。 |
| CallingDataMethods |
在数据方法正被调用时发生。 (继承自 DataBoundControl) |
| CreatingModelDataSource |
当 ModelDataSource 对象正被创建时发生。 (继承自 DataBoundControl) |
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| DataBound |
在服务器控件绑定到数据源后发生。 (继承自 BaseDataBoundControl) |
| Disposed |
当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| EnablePersistedSelection(BaseDataBoundControl) |
已过时.
使选定内容能够保留在支持选择和分页的数据控件中。 |
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
