AdCreatedEventArgs.ImageUrl Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a URL de uma imagem a ser exibida no controle 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
Valor da propriedade
A URL de uma imagem a ser exibida no AdRotator controle . O valor padrão é Empty.
Exemplos
O exemplo de código a seguir demonstra como definir programaticamente a ImageUrl propriedade .
<%@ 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>
O exemplo de código a seguir demonstra como formatar o arquivo XML que contém as informações de anúncio. Para obter mais informações sobre o arquivo XML, consulte a AdvertisementFile propriedade da 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>
Comentários
Use a ImageUrl propriedade para especificar a URL de uma imagem a ser exibida para um anúncio no AdRotator controle . Você pode usar uma URL relativa ou absoluta. Uma URL relativa relaciona o local da imagem ao local da página da Web ou controle de usuário sem especificar um caminho completo no servidor. O caminho é relativo ao local da página da Web. Isso facilita a movimentação de todo o site para outro diretório no servidor sem atualizar o caminho para a imagem no código. Uma URL absoluta fornece o caminho completo, portanto, mover o site para outro diretório requer a atualização do código.
Um arquivo XML separado contém as propriedades do anúncio exibido. O AdRotator controle define automaticamente a ImageUrl propriedade com a entrada de URL de imagem correspondente no arquivo XML que contém as informações de anúncio. Essa propriedade também pode ser usada para definir programaticamente a URL da imagem.
Observação
Se você usar um arquivo de anúncio e especificar uma URL relativa para essa propriedade, a URL será relativa ao diretório no qual o arquivo de anúncio está localizado. Se você definir essa propriedade diretamente com uma URL relativa, em vez de usar o arquivo de anúncio, a URL será relativa ao diretório da página ou controle de usuário que contém o AdRotator controle .