AdRotator.AdCreated AdRotator.AdCreated AdRotator.AdCreated AdRotator.AdCreated Event

Определение

Происходит один раз за время цикла обращения к серверу после создания элемента управления, но до преобразования страницы для просмотра.Occurs once per round trip to the server after the creation of the control, but before the page is rendered.

public:
 event System::Web::UI::WebControls::AdCreatedEventHandler ^ AdCreated;
public event System.Web.UI.WebControls.AdCreatedEventHandler AdCreated;
member this.AdCreated : System.Web.UI.WebControls.AdCreatedEventHandler 
Public Custom Event AdCreated As AdCreatedEventHandler 

Примеры

В следующем примере кода показано, как указать и написать обработчик для AdCreated событий.The following code example demonstrates how to specify and code a handler for the AdCreated event. Он получает URL-адрес, связанный с объявлением, когда AdRotator управления создается и отображает его под элементом управления.It gets the URL associated with the advertisement, when the AdRotator control is created, and displays it below the control.

Примечание

В следующем образце кода используется модель одного файла кода и может работать неправильно, если копируются непосредственно в файл с выделенным кодом.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Этот пример кода должен быть скопирован в пустой текстовый файл с расширением .aspx.This code sample must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм, см. в разделе модель ASP.NET Web Forms страницы кода.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

<%@ 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>
    
<%@ 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>
 
    <script language="vb" runat="server">
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
          Message.Text=e.NavigateUrl
       End Sub
    </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-файле, содержащему рекламные сведения.The following code example demonstrates how to format the XML file that contains the advertisement information. Дополнительные сведения о XML-файле, см. в разделе AdvertisementFile свойство.For more information on the XML file, see the AdvertisementFile property.

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

Примечание

В следующем образце кода используется модель одного файла кода и может работать неправильно, если копируются непосредственно в файл с выделенным кодом.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Этот пример кода должен быть скопирован в пустой текстовый файл с расширением .aspx.This code sample must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм, см. в разделе модель ASP.NET Web Forms страницы кода.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.


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


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

      Sub Page_Load(sender As Object, e As EventArgs)

         ' 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.
         AddHandler Ad.AdCreated, AddressOf AdCreated_Event

      End Sub

      Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 

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

      End Sub      

   </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>

Комментарии

Это событие возникает один раз за время цикла обращения к серверу после создания элемента управления, но перед отображением.This event is raised once per round trip to the server after the creation of the control, but before the page is rendered. Когда AdvertisementFile свойство задано, это событие происходит после выбора рекламного объявления из файла.When the AdvertisementFile property is set, this event occurs after the advertisement has been selected from the file.

Вы можете управлять как AdRotator отображается элемент управления, изменяя аргументы, передаваемые обработчику событий AdCreated событий.You can control how the AdRotator control is displayed by modifying the arguments passed to the event handler of the AdCreated event. Если AdvertisementFile свойство не задано, это позволяет задать рекламные сведения напрямую, не используя отдельный файл рекламных объявлений.If the AdvertisementFile property is not set, this allows you to specify the advertisement information directly, without using a separate advertisement file. Если AdvertisementFile свойство задано, это позволяет расширить поведение AdRotator элемента управления, такие как перенаправление на другую страницу.If the AdvertisementFile property is set, this allows you to extend the behavior of the AdRotator control, such as redirecting to another page.

Примечание

При включении кэширования страниц AdRotator элемент управления не кэшируется.When page caching is enabled, an AdRotator control is not cached. При каждом обновлении веб-страницы, выбирается новое объявление.A new advertisement is selected whenever the Web page refreshes. Новое объявление не выбран, тем не менее, если указать обработчик событий для AdCreated событий.A new advertisement is not selected, however, if you provide an event handler for the AdCreated event.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

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

Дополнительно