AdCreatedEventArgs.ImageUrl Proprietà

Definizione

Ottiene o imposta l'URL di una immagine da visualizzare nel controllo AdRotator.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

Valore della proprietà

URL di una immagine da visualizzare nel controllo AdRotator.The URL of an image to display in the AdRotator control. Il valore predefinito è Empty.The default value is Empty.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come impostare ImageUrl la proprietà a livello di codice.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>

Nell'esempio di codice seguente viene illustrato come formattare il file XML contenente le informazioni sull'annuncio pubblicitario.The following code example demonstrates how to format the XML file that contains the advertisement information. Per ulteriori informazioni sul file XML, vedere la AdvertisementFile proprietà AdRotator della classe.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>  

Commenti

Utilizzare la ImageUrl proprietà per specificare l'URL di un'immagine da visualizzare per un annuncio pubblicitario AdRotator nel controllo.Use the ImageUrl property to specify the URL of an image to display for an advertisement in the AdRotator control. È possibile utilizzare un URL relativo o assoluto.You can use a relative or an absolute URL. Un URL relativo mette in correlazione il percorso dell'immagine al percorso della pagina Web o del controllo utente senza specificare un percorso completo sul server.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. Il percorso è relativo alla posizione della pagina Web.The path is relative to the location of the Web page. In questo modo è più semplice spostare l'intero sito in un'altra directory nel server senza aggiornare il percorso dell'immagine nel codice.This makes it easier to move the entire site to another directory on the server without updating the path to the image in code. Un URL assoluto fornisce il percorso completo, pertanto lo stato di trasferimento del sito a un'altra directory richiede l'aggiornamento del codice.An absolute URL provides the complete path, so moving the site to another directory requires updating the code.

Un file XML separato contiene le proprietà per l'annuncio visualizzato.A separate XML file contains the properties for the displayed advertisement. Il AdRotator controllo imposta automaticamente la ImageUrl proprietà con la voce corrispondente dell'URL dell'immagine nel file XML contenente le informazioni sull'annuncio.The AdRotator control automatically sets the ImageUrl property with the corresponding image URL entry in the XML file containing the advertisement information. Questa proprietà può essere usata anche per impostare l'URL dell'immagine a livello di codice.This property can also be used to programmatically set the image URL.

Nota

Se si usa un file di annuncio e si specifica un URL relativo per questa proprietà, l'URL è relativo alla directory in cui si trova il file dell'annuncio.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. Se si imposta questa proprietà direttamente con un URL relativo, anziché usare il file di annuncio, l'URL è relativo alla directory della pagina o del controllo utente che contiene il AdRotator controllo.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.

Si applica a

Vedi anche