AdCreatedEventArgs AdCreatedEventArgs AdCreatedEventArgs AdCreatedEventArgs Class

Definition

Stellt Daten für das AdCreated-Ereignis des AdRotator-Steuerelements bereit.Provides data for the AdCreated event of the AdRotator control. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class AdCreatedEventArgs : EventArgs
public class AdCreatedEventArgs : EventArgs
type AdCreatedEventArgs = class
    inherit EventArgs
Public Class AdCreatedEventArgs
Inherits EventArgs
Vererbung
AdCreatedEventArgsAdCreatedEventArgsAdCreatedEventArgsAdCreatedEventArgs

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen Handler für das AdCreated -Ereignis angeben und codieren.The following code example demonstrates how to specify and code a handler for the AdCreated event. Sie ruft die URL ab, die der Ankündigung zugeordnet AdRotator ist, wenn das Steuerelement erstellt wird, und zeigt Sie unter dem Steuerelement an.It gets the URL associated with the advertisement when the AdRotator control gets created and displays it below the control. Für dieses Beispiel ist die XML-Datei (ADS. Xml) erforderlich, die im folgenden Beispiel aufgeführt ist.This example requires the XML file (Ads.xml) listed in the example below.

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

Im folgenden Codebeispiel wird veranschaulicht, wie die XML-Datei mit den Ankündigungs Informationen formatiert wird.The following code example demonstrates how to format the XML file that contains the advertisement information. Weitere Informationen zur XML-Datei finden Sie unter der AdvertisementFile -Eigenschaft AdRotator der-Klasse.For more information on the XML file, see the AdvertisementFile property of the AdRotator class.

<Advertisements>  
 <Ad>  
 <ImageUrl>image1.jpg</ImageUrl>  
 <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>image2.jpg</ImageUrl>  
 <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>  

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

Hinweise

Das AdCreated -Ereignis wird ausgelöst, AdRotator wenn das-Steuerelement eine Ankündigung auf der Seite anzeigt.The AdCreated event is raised when the AdRotator control displays an advertisement on the page.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von AdCreatedEventArgsfinden Sie im AdCreatedEventArgs -Konstruktor.For a list of initial property values for an instance of AdCreatedEventArgs, see the AdCreatedEventArgs constructor.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Konstruktoren

AdCreatedEventArgs(IDictionary) AdCreatedEventArgs(IDictionary) AdCreatedEventArgs(IDictionary) AdCreatedEventArgs(IDictionary)

Initialisiert eine neue Instanz der AdCreatedEventArgs-Klasse.Initializes a new instance of the AdCreatedEventArgs class.

Eigenschaften

AdProperties AdProperties AdProperties AdProperties

Ruft ein IDictionary-Objekt ab, das alle Eigenschaften der derzeit angezeigten Werbung enthält.Gets a IDictionary object that contains all the advertisement properties for the currently displayed advertisement.

AlternateText AlternateText AlternateText AlternateText

Ruft den alternativen Text ab, der im AdRotator-Steuerelement angezeigt wird, wenn das Bild für die Werbung nicht verfügbar ist, oder legt diesen fest.Gets or sets the alternate text displayed in the AdRotator control when the advertisement image is unavailable. In Browsern, die das QuickInfo-Feature unterstützen, wird dieser Text als QuickInfo für die Werbung angezeigt.Browsers that support the ToolTips feature display this text as a ToolTip for the advertisement.

ImageUrl ImageUrl ImageUrl ImageUrl

Ruft die URL eines Bilds ab, das im AdRotator-Steuerelement angezeigt werden soll, oder legt diese fest.Gets or sets the URL of an image to display in the AdRotator control.

NavigateUrl NavigateUrl NavigateUrl NavigateUrl

Ruft die Webseite ab, die beim Klicken auf das AdRotator-Steuerelement angezeigt werden soll, oder legt sie fest.Gets or sets the Web page to display when the AdRotator control is clicked.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch