AdRotator.AdvertisementFile Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la ruta de acceso a un archivo XML que contiene información sobre los anuncios.

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 propiedad

String

Ubicación de un archivo XML que contiene información sobre los anuncios. El valor predeterminado es una cadena vacía ("").

Atributos
BindableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la AdvertisementFile propiedad para especificar la ubicación del archivo XML que contiene información del anuncio.

<%@ 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>

En el ejemplo de código siguiente se muestra el formato de archivo del archivo de anuncio 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>

Comentarios

Utilice la AdvertisementFile propiedad para especificar la ubicación de un archivo XML que contiene información de anuncio. El archivo XML debe residir en el mismo sitio web. Para fines de implementación y seguridad, se recomienda encarecidamente colocar el archivo en la misma aplicación web. Solo es posible acceder a un archivo XML que se encuentra en una aplicación diferente en el mismo sitio si la aplicación tiene suficiente confianza.

Puede establecer esta propiedad en una ruta de acceso absoluta o en una ruta de acceso relativa al archivo XML. Use una ruta de acceso relativa para simplificar la implementación. Si usa una ruta de acceso relativa, esa ruta de acceso es relativa a la ubicación de la página o control de usuario que contiene el AdRotator control .

La propiedad AdvertisementFile es opcional. Un anuncio también se puede establecer mediante programación en el AdCreated evento .

El archivo XML contiene los siguientes atributos predefinidos. Solo se requiere el ImageUrl atributo .

Atributo Descripción
ImageUrl La dirección URL de la imagen que se va a mostrar.
Height Alto de la imagen, en píxeles (opcional).
Width Ancho de la imagen, en píxeles (opcional).
NavigateUrl Dirección URL de la página a la que navegar cuando se hace clic en el AdRotator control.
AlternateText Texto que se va a mostrar si la imagen no está disponible. En algunos exploradores, este texto se muestra como información sobre herramientas.
Keyword Categoría del anuncio. El control usa AdRotator esto para filtrar la lista de anuncios de una categoría específica.
Impressions Valor que indica la frecuencia con la que se muestra un anuncio en relación con otros anuncios en el archivo XML.

Nota

Los ImageUrl atributos y NavigateUrl pueden ser una dirección URL completa, una ruta de acceso relativa a la raíz o una ruta de acceso relativa. Si usa una ruta de acceso relativa a la raíz, la ruta de acceso es relativa al mismo sitio web. Si usa una ruta de acceso relativa, la ruta de acceso es relativa al directorio que contiene el archivo de anuncio.

También puede incluir atributos personalizados mediante etiquetas personalizadas en el archivo XML. Todas las etiquetas de atributo se analizan desde el archivo de anuncio y los valores se colocan en el AdProperties diccionario. Puede usar el AdProperties diccionario para acceder mediante programación a los atributos personalizados.

El control no valida la AdRotator información de este archivo. Para evitar que los anuncios ejecuten scripts malintencionados, siempre debes comprobar los datos antes de publicarlos o aceptar información de anuncios solo de orígenes de confianza.

Para proteger su archivo de anuncio de acceso no autorizado a Internet, realice una o varias de las siguientes acciones:

  • Almacénelo en el directorio Datos, que está configurado en Machine.config para denegar el acceso a Internet para archivos de cualquier tipo.
  • Cambie el nombre del archivo por una extensión que no sea .xml y asigne la extensión a HttpForbiddenHandler en Web.config. Para obtener más información, consulte la httpHandlers sección del archivo Machine.config.

Se aplica a

Consulte también