AdCreatedEventArgs.ImageUrl Eigenschaft

Definition

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

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

Die URL eines Bilds, das im AdRotator-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 AdRotator für eine Ankündigung im Steuerelement angezeigt werden soll. Sie können eine relative oder eine absolute URL verwenden. Eine relative 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. Dies erleichtert das Verschieben des gesamten Standorts in ein anderes Verzeichnis auf dem Server, ohne den Pfad zum Image im Code zu aktualisieren. Eine absolute URL stellt den vollständigen Pfad bereit, sodass das Verschieben der Website in ein anderes Verzeichnis eine Aktualisierung des Codes erfordert.

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, die 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 des Seiten- oder Benutzersteuerelements, das das AdRotator Steuerelement enthält.

Gilt für:

Weitere Informationen