AdCreatedEventArgs.ImageUrl Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de URL van een afbeelding op of stelt u deze in om weer te geven in het AdRotator besturingselement.
public:
property System::String ^ ImageUrl { System::String ^ get(); void set(System::String ^ value); };public string ImageUrl { get; set; }member this.ImageUrl : string with get, setPublic Property ImageUrl As StringWaarde van eigenschap
De URL van een afbeelding die moet worden weergegeven in het AdRotator besturingselement. De standaardwaarde is Empty.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de ImageUrl eigenschap programmatisch instelt.
<%@ 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>
In het volgende codevoorbeeld ziet u hoe u het XML-bestand opmaken dat de advertentiegegevens bevat. Zie de AdvertisementFile eigenschap van de AdRotator klasse voor meer informatie over het XML-bestand.
<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>
Opmerkingen
Gebruik de ImageUrl eigenschap om de URL van een afbeelding op te geven die moet worden weergegeven voor een advertentie in het AdRotator besturingselement. U kunt een relatieve of absolute URL gebruiken. Een relatieve URL heeft betrekking op de locatie van de afbeelding op de locatie van de webpagina of het gebruikersbeheer zonder een volledig pad op de server op te geven. Het pad is relatief ten opzichte van de locatie van de webpagina. Hierdoor is het eenvoudiger om de hele site naar een andere map op de server te verplaatsen zonder het pad naar de afbeelding in code bij te werken. Een absolute URL biedt het volledige pad, dus het verplaatsen van de site naar een andere map vereist het bijwerken van de code.
Een afzonderlijk XML-bestand bevat de eigenschappen voor de weergegeven advertentie. Het AdRotator besturingselement stelt de ImageUrl eigenschap automatisch in met de bijbehorende afbeeldings-URL-vermelding in het XML-bestand met de advertentiegegevens. Deze eigenschap kan ook worden gebruikt om de afbeeldings-URL programmatisch in te stellen.
Note
Als u een advertentiebestand gebruikt en een relatieve URL voor deze eigenschap opgeeft, is de URL relatief ten opzichte van de map waarin het advertentiebestand zich bevindt. Als u deze eigenschap rechtstreeks met een relatieve URL instelt in plaats van het advertentiebestand te gebruiken, is de URL relatief ten opzichte van de map van de pagina of het gebruikersbesturingselement dat het AdRotator besturingselement bevat.
