AdCreatedEventArgs.ImageUrl Eigenschaft

Definition

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.

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.The URL of an image to display in the AdRotator control. Der Standardwert ist Emptysein.The default value is Empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ImageUrl -Eigenschaft Programm gesteuert festgelegt wird.The following code example demonstrates how to programmatically set the ImageUrl property.

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

Hinweise

Verwenden Sie ImageUrl die-Eigenschaft, um die URL eines Bilds anzugeben, das für eine AdRotator Ankündigung im-Steuerelement angezeigt werden soll.Use the ImageUrl property to specify the URL of an image to display for an advertisement in the AdRotator control. Sie können eine relative oder eine absolute URL verwenden.You can use a relative or an absolute URL. Eine relative URL die den Speicherort des Bilds mit dem Speicherort der Webseite oder des Benutzer Steuer Elements verknüpft, ohne einen kompletten Pfad auf dem Server anzugeben.A relative URL relates the location of the image to the location of the Web page or user control without specifying a complete path on the server. Der Pfad ist relativ zum Speicherort der Webseite.The path is relative to the location of the Web page. Dadurch ist es einfacher, die gesamte Website in ein anderes Verzeichnis auf dem Server zu verschieben, ohne den Pfad zu dem Image im Code zu aktualisieren.This makes it easier to move the entire site to another directory on the server without updating the path to the image in code. Eine absolute URL stellt den gesamten Pfad bereit. Wenn Sie also die Website in ein anderes Verzeichnis verschieben möchten, müssen Sie den Code aktualisieren.An absolute URL provides the complete path, so moving the site to another directory requires updating the code.

Eine separate XML-Datei enthält die Eigenschaften für die angezeigte Ankündigung.A separate XML file contains the properties for the displayed advertisement. Das AdRotator -Steuerelement legt ImageUrl die-Eigenschaft mit dem entsprechenden Bild-URL-Eintrag in der XML-Datei mit den Ankündigungs Informationen automatisch fest.The AdRotator control automatically sets the ImageUrl property with the corresponding image URL entry in the XML file containing the advertisement information. Diese Eigenschaft kann auch verwendet werden, um die Bild-URL Programm gesteuert festzulegen.This property can also be used to programmatically set the image URL.

Hinweis

Wenn Sie eine Ankündigungs Datei verwenden und eine relative URL für diese Eigenschaft angeben, ist die URL relativ zum Verzeichnis, in dem sich die Ankündigungs Datei befindet.If you use an advertisement file and specify a relative URL for this property, the URL is relative to the directory that the advertisement file is located in. Wenn Sie diese Eigenschaft direkt auf einen relative URL festlegen, ist die URL relativ zum Verzeichnis der Seite oder des Benutzer Steuer Elements, das das AdRotator Steuerelement enthält, anstatt die Ankündigungs Datei zu verwenden.If you set this property directly with a relative URL, instead of using the advertisement file, the URL is relative to the directory of the page or user control that contains the AdRotator control.

Gilt für:

Siehe auch