Freigeben über

AdCreatedEventArgs.ImageUrl Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen der URL eines Bilds, das AdRotator im Steuerelement angezeigt werden soll.

public:
 property System::String ^ ImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string ImageUrl { get; set; }
member this.ImageUrl : string with get, set
Public Property ImageUrl As String

Eigenschaftswert

String

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ImageUrl Eigenschaft programmgesteuert festgelegt wird.

<%@ 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>AdCreatedEventArgs ImageUrl Example</title>
<script runat="server">
   
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {

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

   </script>
 
</head>
 
<body>
 
   <form id="form1" 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="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>AdCreatedEventArgs ImageUrl Example</title>
<script runat="server">
   
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
       
          e.ImageUrl = "images/newimage.jpg"   
       
       End Sub      

   </script>
 
</head>
 
<body>
 
   <form id="form1" 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 veranschaulicht, wie die XML-Datei formatiert wird, die die Ankündigungsinformationen enthält. Weitere Informationen zur XML-Datei finden Sie in der AdvertisementFile Eigenschaft der AdRotator Klasse.

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

Hinweise

Verwenden Sie die ImageUrl Eigenschaft, um die URL eines Bilds anzugeben, das für eine Anzeige im AdRotator Steuerelement angezeigt werden soll. Sie können eine relative oder eine absolute URL verwenden. Eine relative URL bezieht sich auf den Speicherort des Bilds auf den Speicherort der Webseite oder des Benutzersteuerelements, ohne einen vollständigen Pfad auf dem Server anzugeben. Der Pfad ist relativ zum Speicherort der Webseite. Dadurch wird es einfacher, den gesamten Standort in ein anderes Verzeichnis auf dem Server zu verschieben, ohne den Pfad zum Bild im Code zu aktualisieren. Eine absolute URL stellt den vollständigen Pfad bereit, sodass das Verschieben der Website in ein anderes Verzeichnis erfordert, dass der Code aktualisiert wird.

Eine separate XML-Datei enthält die Eigenschaften für die angezeigte Ankündigung. Das AdRotator Steuerelement legt die ImageUrl Eigenschaft automatisch mit dem entsprechenden Bild-URL-Eintrag in der XML-Datei fest, der die Ankündigungsinformationen enthält. Diese Eigenschaft kann auch verwendet werden, um die Bild-URL programmgesteuert festzulegen.

Hinweis

Wenn Sie eine Ankündigungsdatei verwenden und eine relative URL für diese Eigenschaft angeben, ist die URL relativ zum Verzeichnis, in dem sich die Ankündigungsdatei befindet. Wenn Sie diese Eigenschaft direkt mit einer relativen URL festlegen, anstatt die Ankündigungsdatei zu verwenden, ist die URL relativ zum Verzeichnis der Seite oder des Benutzersteuerelements, das das AdRotator Steuerelement enthält.

Gilt für:

Weitere Informationen