AdRotator.AdvertisementFile Propiedad
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Ubicación de un archivo XML que contiene información sobre los anuncios. El valor predeterminado es una cadena vacía ("").
- Atributos
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>
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 lahttpHandlers
sección del archivo Machine.config.
Producto | Versiones |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: