AdCreatedEventArgs.ImageUrl Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l'URL d'une image à afficher dans le contrôle AdRotator.
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
Valeur de propriété
URL d'une image à afficher dans le contrôle AdRotator. La valeur par défaut est Empty.
Exemples
L’exemple de code suivant montre comment définir la ImageUrl propriété par programmation.
<%@ 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>
L’exemple de code suivant montre comment mettre en forme le fichier XML qui contient les informations de publication. Pour plus d’informations sur le fichier XML, consultez la AdvertisementFile propriété de la AdRotator classe .
<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>
Remarques
Utilisez la ImageUrl propriété pour spécifier l’URL d’une image à afficher pour une publication dans le AdRotator contrôle . Vous pouvez utiliser une URL relative ou absolue. Une URL relative lie l’emplacement de l’image à l’emplacement de la page Web ou du contrôle utilisateur sans spécifier de chemin d’accès complet sur le serveur. Le chemin d’accès est relatif à l’emplacement de la page Web. Cela facilite le déplacement de l’ensemble du site vers un autre répertoire sur le serveur sans mettre à jour le chemin d’accès à l’image dans le code. Une URL absolue fournit le chemin d’accès complet. Le déplacement du site vers un autre répertoire nécessite donc la mise à jour du code.
Un fichier XML distinct contient les propriétés de la publication affichée. Le AdRotator contrôle définit automatiquement la ImageUrl propriété avec l’entrée d’URL d’image correspondante dans le fichier XML contenant les informations de publication. Cette propriété peut également être utilisée pour définir par programmation l’URL de l’image.
Notes
Si vous utilisez un fichier de publication et que vous spécifiez une URL relative pour cette propriété, l’URL est relative au répertoire dans lequel se trouve le fichier de publication. Si vous définissez cette propriété directement avec une URL relative, au lieu d’utiliser le fichier de publication, l’URL est relative au répertoire de la page ou du contrôle utilisateur qui contient le AdRotator contrôle.