使用英语阅读

通过

AdRotator.AdCreated 事件

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

在控件创建后、呈现页面前，在每个到服务器的往返行程过程中发生一次。

C# 
public event System.Web.UI.WebControls.AdCreatedEventHandler AdCreated;

事件类型

AdCreatedEventHandler

示例

下面的代码示例演示如何为 AdCreated 事件指定和编码处理程序。 创建控件时 AdRotator ，它会获取与播发关联的 URL，并将其显示在控件下方。

备注

下面的代码示例使用单文件代码模型，如果直接复制到代码隐藏文件中，可能无法正常工作。 此代码示例必须复制到扩展名为 .aspx 的空文本文件中。 有关 Web 窗体代码模型的详细信息，请参阅 ASP.NET Web 窗体页代码模型。

ASP.NET (C#) 
<%@ 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>
 
    <script language="c#" runat="server">
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {
          Message.Text=e.NavigateUrl;   
       }      
    </script>
 
 <body>
 
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="test1" runat="server"
            AdvertisementFile = "~/App_Data/Ads.xml"
            Borderwidth="1"
            Target="_blank"
            OnAdCreated="AdCreated_Event"/><br /><br />
 
       <asp:label id="Message" runat="server"/>
 
    </form>
 
 </body>
 </html>

下面的代码示例演示如何设置包含播发信息的 XML 文件的格式。 有关 XML 文件的详细信息，请参阅 AdvertisementFile 属性。

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>

备注

下面的代码示例使用单文件代码模型，如果直接复制到代码隐藏文件中，可能无法正常工作。 此代码示例必须复制到扩展名为 .aspx 的空文本文件中。 有关 Web 窗体代码模型的详细信息，请参阅 ASP.NET Web 窗体页代码模型。

ASP.NET (C#) 

<%@ 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 AdCreated Example</title>
</head>
 
   <script runat="server">

      void Page_Load(Object sender, EventArgs e)
      {

         // Create an EventHandler delegate for the method you want to handle the event
         // and then add it to the list of methods called when the event is raised.
         Ad.AdCreated += new System.Web.UI.WebControls.AdCreatedEventHandler(this.AdCreated_Event);

      }

      void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
      {

         // Override the AlternateText value from the ads.xml file.
         e.AlternateText = "Visit this site!";   

      }      

   </script>
 
<body>
 
   <form id="form1" runat="server">
 
      <h3>AdRotator AdCreated Example</h3>

      Notice that the AlternateText property of the advertisement <br />
      has been programmatically modified from the value in the XML <br />
      file. 

      <br /><br />
 
      <asp:AdRotator id="Ad" runat="server"
           AdvertisementFile = "~/App_Data/Ads.xml"
           Borderwidth="1"
           Target="_blank"/>
 
   </form>
 
</body>
</html>

注解

在创建控件之后、呈现页面之前，每次往返到服务器时，将引发此事件一次。 AdvertisementFile设置 属性后，从 文件选择播发后发生此事件。

可以通过修改传递给事件的事件处理程序的参数来控制控件的AdCreated显示方式AdRotator。 AdvertisementFile如果未设置 属性，则允许直接指定播发信息，而无需使用单独的播发文件。 AdvertisementFile如果设置了 属性，则可以扩展控件的行为AdRotator，例如重定向到另一页。

备注

启用页面缓存时， AdRotator 不会缓存控件。 每当网页刷新时，将选择一个新播发。 但是，如果为事件提供事件处理程序，则不会选择新播发 AdCreated 。

有关处理事件的详细信息，请参阅 处理和引发事件。

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅