AdRotator Control

Definition and Usage

The AdRotator control is used to display a sequence of ad images in a mobile page.

This control uses an XML file to store the ad information. The XML file must begin and end with an <Advertisements> tag. Inside the <Advertisements> tag there may be several <Ad> tags which defines each ad.

The predefined elements inside the <Ad> tag are listed below:

Element	Description
<ImageUrl>	Optional. The URL of the image to display
<NavigateUrl>	Optional. The URL of the page to display if the user clicks the ad
<OptionalImageUrl>	Optional. The URL of a monochrome image to display
<OptionalNavigateUrl>	Optional.
<AlternateText>	Optional. An alternate text for the image
<Keyword>	Optional. A category for the ad (used to filter ads)
<Impressions>	Optional. The display rates in percent of the hits

Properties

Property	Value	Description
AdvertisementFile	URL	Optional. The path to the XML file that contains ad information
Alignment	left center right	Optional. How to align the control
BackColor	rgb(x,x,x) #xxxxxx colorname	Optional. A background color for the control
ForeColor	rgb(x,x,x) #xxxxxx colorname	Optional. A foreground color for the control
Font-Bold	false true	Optional. Specifies whether or not the text in the control should be bold
Font-Italic	false true	Optional. Specifies whether or not the text in the control should be italic
Font-Name	fontname	Optional. Specifies the font name of the text in the control
Font-Size	normal small large	Optional. Specifies the font size of the text in the control
id	unique_name	Optional. A unique id for the control
ImageKey	imagekey	Optional. Specifies the name from which the image URL is retrieved from an ad
KeywordFilter	filter	Optional. A filter to limit ads after categories
NavigateUrlKey	navigateurlkey	Optional. Specifies the element name from which the target URL is retrieved from an ad
OnAdCreated	function_name	Optional. he name of the function to be executed after the creation of the control, before page rendering
runat	"server"	Required. Specifies that the control is a server control
StyleReference	name_of_style_element	Optional. Specifies a reference to a style to be applied to the control
Wrapping	wrap nowrap	Optional. Specifies whether or not the text in the control should wrap

Example 1

The following example contains one form in an .aspx file. The form contains a AdRotator control that will rotate between three images:

<%@ Page 
Inherits="System.Web.UI.MobileControls.MobilePage"%>
<%@ Register TagPrefix="Mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>

<Mobile:Form runat="server">
  <Mobile:AdRotator runat="server"
  AdvertisementFile="advertisements.xml" />
</Mobile:Form>

This is the ad file called "advertisements.xml":

<?xml version="1.0" ?>
<Advertisements>

<Ad>
<ImageUrl>image1.gif</ImageUrl>
<NavigateUrl>http://www.1.com</NavigateUrl>
<AlternateText>Visit 1</AlternateText>
</Ad>

<Ad>
<ImageUrl>image2.gif</ImageUrl>
<NavigateUrl>http://www.2.com</NavigateUrl>
<AlternateText>Visit 2</AlternateText>
</Ad>

<Ad>
<ImageUrl>image3.gif</ImageUrl>
<NavigateUrl>http://www.3.com</NavigateUrl>
<AlternateText>Visit 3</AlternateText>
</Ad>

</Advertisements>

Jump to: Top of Page or HOME or Printer friendly page

Search W3Schools:

What Others Say About Us

Does the world know about us? Check out these places:

Dogpile Alta Vista MSN Google Excite Lycos Yahoo Ask Jeeves

We Help You For Free. You Can Help Us!

W3Schools is for training only. We do not warrant its correctness or its fitness for use. The risk of using it remains entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

How we converted to XHTML

Active Server Pages Resource Web Site

Your own Web Site?

Read W3Schools
Hosting Tutorial

$15 Domain Name
Registration
Save $20 / year!

Advertise
at W3Schools

Only 0.5 CPM

SELECTED LINKS

University Online
Master Degree
Bachelor Degree

Web Software

The Future of
Web Development

Jobs and Careers

Web Security
Web Statistics
Web Standards

PARTNERS

W3Schools
TopXML
VisualBuilder
XMLPitstop
DevelopersDex
DevGuru
Programmers Heaven
The Code Project
Tek Tips Forum
ZVON.ORG
TopXML Search