AdRotator.AdvertisementFile Propriedade

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Obtém ou define o caminho para um ficheiro XML que contém informação de publicidade.

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 de Propriedade

String

A localização de um ficheiro XML que contém informação de publicidade. O valor padrão é uma cadeia vazia ("").

Atributos: BindableAttribute

Exemplos

O exemplo de código seguinte demonstra como usar a AdvertisementFile propriedade para especificar a localização do ficheiro XML que contém informação de publicidade.

<%@ 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 seguinte exemplo de código mostra o formato do ficheiro 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>

Observações

Use a AdvertisementFile propriedade para especificar a localização de um ficheiro XML que contenha informação de publicidade. O ficheiro XML deve residir no mesmo site. Para fins de implementação e segurança, é fortemente recomendado que coloque o ficheiro na mesma aplicação Web. Só é possível aceder a um ficheiro XML localizado numa aplicação diferente no mesmo site se a aplicação tiver confiança suficiente.

Pode definir esta propriedade para um caminho absoluto ou um caminho relativo ao ficheiro XML. Use um caminho relativo para simplificar a implementação. Se usar um caminho relativo, esse caminho é relativo à localização da página ou ao controlo do utilizador que contém o AdRotator controlo.

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

O ficheiro XML contém os seguintes atributos predefinidos. Apenas o ImageUrl atributo é exigido.

Attribute	Descrição
`ImageUrl`	O URL da imagem a ser exibida.
`Height`	A altura da imagem, em píxeis (opcional).
`Width`	A largura da imagem, em píxeis (opcional).
`NavigateUrl`	O URL da página para navegar quando o AdRotator controlo é clicado.
`AlternateText`	O texto a mostrar caso a imagem não esteja disponível. Em alguns navegadores, este texto é apresentado como uma dica de ferramenta.
`Keyword`	A categoria do anúncio. Isto é usado pelo AdRotator controlo para filtrar a lista de anúncios de uma categoria específica.
`Impressions`	Um valor que indica com que frequência um anúncio é exibido em relação a outros anúncios no ficheiro XML.

Note

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

Também pode incluir atributos personalizados usando etiquetas personalizadas no ficheiro XML. Todas as etiquetas de atributos são analisadas a partir do ficheiro de anúncio, e os valores são colocados no AdProperties dicionário. Podes usar o AdProperties dicionário para aceder programaticamente aos teus atributos personalizados.

A informação neste ficheiro não é validada pelo AdRotator controlo. Para evitar que anúncios executem scripts maliciosos, deve sempre verificar os dados antes de os divulgar, ou aceitar informações de anúncios apenas de fontes confiáveis.

Para proteger o seu ficheiro publicitário contra acesso não autorizado à Internet, faça uma ou mais das seguintes ações:

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

Aplica-se a

Ver também

Comentários

Esta página foi útil?