HOME HTML CSS XML JAVASCRIPT ASP PHP SQL MORE...

.NET Mobile

Mobile HOME
Mobile Intro
Mobile Example
Mobile Emulators
Mobile Forms
Mobile Events
Mobile Input
Mobile Validation
Mobile Lists
Mobile Selection
Mobile Images
Mobile Utilities

Reference

Mobile Reference

ASP.NET Mobile AdRotator Control

Complete ASP.NET Mobile Reference

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>