AdRotator.OnAdCreated-Methode

Artikel
08/20/2007

Löst das AdCreated-Ereignis für das AdRotator-Steuerelement aus.

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

Syntax

'Declaration
Protected Overridable Sub OnAdCreated ( _
    e As AdCreatedEventArgs _
)
'Usage
Dim e As AdCreatedEventArgs

Me.OnAdCreated(e)

protected virtual void OnAdCreated (
    AdCreatedEventArgs e
)

protected:
virtual void OnAdCreated (
    AdCreatedEventArgs^ e
)

protected void OnAdCreated (
    AdCreatedEventArgs e
)

protected function OnAdCreated (
    e : AdCreatedEventArgs
)

Parameter

e
Eine Instanz des AdCreatedEventArgs-Konstruktors mit den Ereignisdaten.

Hinweise

Das AdCreated-Ereignis tritt auf dem Server ein, nachdem das AdRotator-Steuerelement erstellt wurde, jedoch vor der Darstellung der Seite. Wenn die AdvertisementFile-Eigenschaft festgelegt ist, tritt das AdCreated-Ereignis ein, nachdem durch das AdRotator-Steuerelement eine Werbung ausgewählt wurde.

Durch das Auslösen eines Ereignisses wird über einen Delegaten die Methode zur Ereignisbehandlung aufgerufen. Weitere Informationen finden Sie unter Gewusst wie: Verarbeiten von Ereignissen in einer Web Forms-Anwendung.

Hinweise für Erben Wenn Sie OnAdCreated in einer abgeleiteten Klasse überschreiben, müssen Sie die OnAdCreated-Methode der Basisklasse aufrufen.

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.

<%@ 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 über die 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>

<%@ 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
AdCreated
AdCreatedEventHandler-Delegat
AdCreatedEventArgs-Klasse

Weitere Ressourcen

AdRotator-Webserver-Steuerelement
Gewusst wie: Verarbeiten von Ereignissen in einer Web Forms-Anwendung

Freigeben über