AdCreatedEventArgs.ImageUrl-Eigenschaft

Artikel
08/20/2007

Ruft den URL eines Bilds ab, das im AdRotator-Steuerelement angezeigt werden soll, oder legt diesen fest.

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

Syntax

'Declaration
Public Property ImageUrl As String
'Usage
Dim instance As AdCreatedEventArgs
Dim value As String

value = instance.ImageUrl

instance.ImageUrl = value

public string ImageUrl { get; set; }

public:
property String^ ImageUrl {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ImageUrl ()

/** @property */
public void set_ImageUrl (String value)

public function get ImageUrl () : String

public function set ImageUrl (value : String)

Eigenschaftenwert

Der URL eines Bilds, das im AdRotator-Steuerelement angezeigt werden soll. Der Standardwert ist String.Empty.

Hinweise

Mithilfe der ImageUrl-Eigenschaft können Sie den URL des Bilds angeben, das im AdRotator-Steuerelement für eine Werbung angezeigt werden soll. Sie können einen relativen oder einen absoluten URL verwenden. Ein relativer URL verknüpft den Speicherort des Bilds mit dem Speicherort der Webseite oder des Benutzersteuerelements, ohne einen vollständigen Pfad auf dem Server anzugeben. Der Pfad ist relativ zum Speicherort der Webseite. Auf diese Weise wird das Verschieben der gesamten Site in ein anderes Verzeichnis auf dem Server vereinfacht, denn der Pfad des Bilds muss im Code nicht aktualisiert werden. Ein absoluter URL stellt den vollständigen Pfad bereit, sodass für das Verschieben der Site in ein anderes Verzeichnis das Aktualisieren des Codes erforderlich ist.

Eine separate XML-Datei enthält die Eigenschaften für die angezeigte Werbung. Das AdRotator-Steuerelement legt die ImageUrl-Eigenschaft automatisch auf den betreffenden Eintrag für den Bild-URL fest, der sich in der XML-Datei mit den Daten über die Werbung befindet. Diese Eigenschaft kann auch zum programmgesteuerten Festlegen des URLs des Bilds verwendet werden.

Hinweis

Wenn Sie eine Datei für die Werbung verwenden und einen relativen URL für diese Eigenschaft angeben, ist der URL relativ zu dem Verzeichnis, in dem sich die Datei für die Werbung befindet. Wenn Sie diese Eigenschaft direkt mit einem relativen URL festlegen und nicht die Datei für die Werbung verwenden, ist der URL relativ zum Verzeichnis der Seite oder zum Benutzersteuerelement mit dem AdRotator-Steuerelement.

Beispiel

Im folgenden Codebeispiel wird das programmgesteuerte Festlegen der ImageUrl-Eigenschaft veranschaulicht.

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

<html>
<head>

   <script runat="server">
   
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
       
          e.ImageUrl = "images/newimage.jpg"   
       
       End Sub      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdCreatedEventArgs ImageUrl Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {

          e.ImageUrl = "images/newimage.jpg";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdCreatedEventArgs ImageUrl Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

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

<html>
<head>

   <script runat="server">
   
       function AdCreated_Event(sender : Object, e : AdCreatedEventArgs)
       {

          e.ImageUrl = "images/newimage.jpg";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdCreatedEventArgs ImageUrl Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

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

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

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

AdCreatedEventArgs-Klasse
AdCreatedEventArgs-Member
System.Web.UI.WebControls-Namespace
AdRotator
AdvertisementFile
String.Empty

Freigeben über