Partilhar via


AdRotator.AdvertisementFile Propriedade

Definição

Obtém ou define o caminho para um arquivo XML que contém informações de anúncio.

public:
 property System::String ^ AdvertisementFile { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string AdvertisementFile { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.AdvertisementFile : string with get, set
Public Property AdvertisementFile As String

Valor da propriedade

O local de um arquivo XML que contém informações de anúncio. O valor padrão é uma cadeia de caracteres vazia ("").

Atributos

Exemplos

O exemplo de código a seguir demonstra como usar a AdvertisementFile propriedade para especificar o local do arquivo XML que contém informações de anúncio.

<%@ 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>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </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>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

O exemplo de código a seguir mostra o formato de arquivo do arquivo de anúncio XML.

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/image1.jpg</ImageUrl>  
    <Height>60</Height>  
    <Width>190</Width>  
    <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>~/Images/image2.jpg</ImageUrl>  
    <Height>90</Height>  
    <Width>90</Width>  
    <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 AdvertisementFile propriedade para especificar o local de um arquivo XML que contém informações de anúncio. O arquivo XML deve residir no mesmo site. Para fins de implantação e segurança, é altamente recomendável colocar o arquivo no mesmo aplicativo Web. Só é possível acessar um arquivo XML localizado em um aplicativo diferente no mesmo site se o aplicativo tiver confiança suficiente.

Você pode definir essa propriedade como um caminho absoluto ou um caminho relativo ao arquivo XML. Use um caminho relativo para simplificar a implantação. Se você usar um caminho relativo, esse caminho será relativo ao local da página ou do controle de usuário que contém o AdRotator controle .

A propriedade AdvertisementFile é opcional. Um anúncio também pode ser definido programaticamente no AdCreated evento.

O arquivo XML contém os seguintes atributos predefinidos. Somente o ImageUrl atributo é necessário.

Atributo Descrição
ImageUrl A URL da imagem para exibir.
Height A altura da imagem, em pixels (opcional).
Width A largura da imagem, em pixels (opcional).
NavigateUrl A URL da página para a qual navegar quando o AdRotator controle for clicado.
AlternateText O texto a ser exibido se a imagem não estiver disponível. Em alguns navegadores, esse texto é exibido como uma Dica de Ferramenta.
Keyword A categoria do anúncio. Isso é usado pelo AdRotator controle para filtrar a lista de anúncios de uma categoria específica.
Impressions Um valor que indica a frequência com que um anúncio é exibido em relação a outros anúncios no arquivo XML.

Observação

Os ImageUrl atributos e NavigateUrl podem ser uma URL completa, um caminho relativo à raiz ou um caminho relativo. Se você usar um caminho relativo à raiz, o caminho será relativo ao mesmo site. Se você usar um caminho relativo, o caminho será relativo ao diretório que contém o arquivo de anúncio.

Você também pode incluir atributos personalizados usando marcas personalizadas no arquivo XML. Todas as marcas de atributo são analisadas do arquivo de anúncio e os valores são colocados no AdProperties dicionário. Você pode usar o AdProperties dicionário para acessar programaticamente seus atributos personalizados.

As informações neste arquivo não são validadas pelo AdRotator controle . Para impedir que anúncios executem scripts mal-intencionados, você deve sempre marcar os dados antes de liberá-los ou aceitar informações de anúncio somente de fontes confiáveis.

Para proteger seu arquivo de anúncio contra acesso não autorizado à Internet, faça um ou mais dos seguintes procedimentos:

  • Armazene-o no diretório Dados, que está configurado em Machine.config para negar o acesso à Internet para arquivos de qualquer tipo.
  • Renomeie o arquivo com uma extensão que não é .xml e mapeie a extensão para HttpForbiddenHandler em Web.config. Para obter mais informações, consulte a httpHandlers seção no arquivo Machine.config.

Aplica-se a

Confira também