AdRotator.AdCreated-Ereignis

Artikel
08/20/2007

Tritt nach dem Erstellen des Steuerelements einmal pro Schleife zum Server ein, jedoch vor der Darstellung der Seite.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Event AdCreated As AdCreatedEventHandler
'Usage
Dim instance As AdRotator
Dim handler As AdCreatedEventHandler

AddHandler instance.AdCreated, handler

public event AdCreatedEventHandler AdCreated

public:
event AdCreatedEventHandler^ AdCreated {
    void add (AdCreatedEventHandler^ value);
    void remove (AdCreatedEventHandler^ value);
}

/** @event */
public void add_AdCreated (AdCreatedEventHandler value)

/** @event */
public void remove_AdCreated (AdCreatedEventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Dieses Ereignis tritt nach dem Erstellen des Steuerelements einmal pro Schleife zum Server ein, jedoch vor der Darstellung der Seite. Wenn die AdvertisementFile-Eigenschaft festgelegt ist, tritt dieses Ereignis nach dem Auswählen der Werbung aus der Datei ein.

Durch Bearbeiten der Argumente, die dem Ereignishandler des AdCreated-Ereignisses übergeben werden, können Sie die Darstellungsweise des AdRotator-Steuerelements kontrollieren. Wenn die AdvertisementFile-Eigenschaft nicht festgelegt ist, können Sie hiermit die Informationen über die Werbung direkt angeben, ohne eine separate Datei für die Werbung zu verwenden. Wenn die AdvertisementFile-Eigenschaft festgelegt ist, können Sie hiermit das Verhalten des AdRotator-Steuerelements erweitern, sodass z. B. eine Umleitung zu einer anderen Seite erfolgt.

Hinweis

Wenn die Seitenzwischenspeicherung aktiviert ist, wird ein AdRotator-Steuerelement nicht zwischengespeichert. Bei jeder Aktualisierung der Webseite wird eine neue Werbung ausgewählt. Wenn Sie einen Ereignishandler für das AdCreated-Ereignis bereitstellen, wird keine neue Werbung ausgewählt.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.

Thema	Position
Gewusst wie: Programmgesteuertes Auswählen von Anzeigen in einem AdRotator-Webserversteuerelement	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Auswählen von Anzeigen in einem AdRotator-Webserversteuerelement	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Auswählen von Anzeigen in einem AdRotator-Webserversteuerelement	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird das Angeben und Codieren eines Handlers für das AdCreated-Ereignis veranschaulicht. Der der Werbung zugeordnete URL wird beim Erstellen des AdRotator-Steuerelements abgerufen und unterhalb des Steuerelements angezeigt.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="VB" runat="server">
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
          Message.Text=e.href
       End Sub
    </script>
 
 <body>
 
    <form 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="C#" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="C#" runat="server">
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {
          Message.Text=e.href;   
       }      
    </script>
 
 <body>
 
    <form 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="JScript" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="JScript" runat="server">
       function AdCreated_Event(sender, e : AdCreatedEventArgs) 
       {
          Message.Text=e.href;   
       }      
    </script>
 
 <body>
 
    <form 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>

Im folgenden Codebeispiel wird das Formatieren der XML-Datei veranschaulicht, die die Informationen über die Werbung enthält. Weitere Informationen zur XML-Datei finden Sie unter der AdvertisementFile-Eigenschaft.

<Advertisements>
  <Ad>
    <ImageUrl>~/Images/image1.jpg</ImageUrl>
    <Height>60</Height>
    <Width>190</Width>
    <href>https://www.microsoft.com</href>
    <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>
    <href>http://www.wingtiptoys.com</href>
    <AlternateText>Wingtip Toys</AlternateText>
    <Impressions>80</Impressions>
    <Keyword>Topic2</Keyword>
    <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
</Advertisements>

Hinweis

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>
 
</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 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="C#" AutoEventWireup="True" %>

<html>
<head>
 
</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 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.xmla"
           Borderwidth="1"
           Target="_blank"/>
 
   </form>
 
</body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AdRotator-Klasse
AdRotator-Member
System.Web.UI.WebControls-Namespace
OnAdCreated
AdCreatedEventHandler-Delegat
AdCreatedEventArgs-Klasse

Weitere Ressourcen

AdRotator-Webserver-Steuerelement

Freigeben über

AdRotator.AdCreated-Ereignis

Syntax

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Weitere Ressourcen

Zusätzliche Ressourcen