AdRotator Web Server Control Overview

The AdRotator Web server control can be used to display graphics that are linked to other pages. The list of graphics to be displayed and the associated target links is maintained in a data source such as an XML file or database.

This topic contains:

  • Scenarios

  • Background

  • Code Examples

  • Class Reference


The AdRotator Web server control provides a way to display advertisements (ads) on your ASP.NET Web pages. The control displays a .gif file or other graphic image that you provide. When users click the ad, they are redirected to a target URL that you have specified. The control automatically reads advertisement information, such as the graphic file name and the target URL, from a list of ads that you provide using a data source, which is usually an XML file or a database table.

The AdRotator control selects ads randomly, changing the displayed ad each time the page is refreshed. Ads can be weighted to control the priority level of banners, making it possible to have certain ads display more often than others. You can also write custom logic that cycles through the ads.

Back to top


The AdRotator Web server control can be used to display ad graphics such as a .gif or similar image. The user can then be redirected to a target URL. The graphic and target URL can be provided from a data source such as an XML file.

Ad information can come from a variety of sources, such as the following:

  • An XML file. You can store ad information in an XML file that contains references to ad banners and their associated properties.

  • Any data source control, such as the SqlDataSource or ObjectDataSource controls. For example, you can store ad information in a database, use a SqlDataSource control to retrieve ad information, and then bind the AdRotator control to the data source control.

  • Custom logic. You can create a handler for the AdCreated event and select an ad during the event.

XML File Format for Ad Files

One method of storing ad-banner image locations, URLs for redirection, and associated properties is to put the information in an XML file. By using the XML file format, you can create and maintain a list of advertisements without having to change the code in your application whenever a change is made to an advertisement. For details, see How to: Display Ads From an XML File Using the AdRotator Web Server Control.

Database Schema for Ad Files

Instead of creating an XML file for ad information, you can store ad information in a database table. The table requires a specific schema that the AdRotator control can read. For details, see How to: Display Ads From a Database Using the AdRotator Web Server Control.

Filtering Ads by Keyword

In the advertisement file, you can assign categories to ads by using the Keyword attribute and then configuring the AdRotator control to show ads according to the filter criteria that you specify. For example, if an ad file contains categories for both banks and hardware stores, you might want the page to display only ads that are related to banks. By setting the AdRotator control's KeywordFilter property to "banks," you can have the control filter out the hardware store ads.

If a filter is specified, one of the following two situations can result:

  • If the AdRotator control can find ads with the matching keyword, an ad with the keyword is displayed.

  • If no match for the keyword exists, the AdRotator control displays a blank image in the browser.

Tracking Ad Response

The AdRotator control does not inherently provide a way to gather statistics about which ads users have clicked, how many times an ad has been clicked, and so on. However, because you have control over the URL to which the ad points, you can add tracking logic for the ads to your application. A typical way to do this is to point all ads to a tracking page that first gathers the statistics you want, and then jumps to the ad's destination page.

Caching Ads

If the page that contains the AdRotator control is cached, the AdRotator control automatically performs cache substitution to replace the cached ad with a new one whenever the page is retrieved from the cache. For more information, see Dynamically Updating Portions of a Cached Page.

Code Examples

How to: Display Ads From an XML File Using the AdRotator Web Server Control

How to: Display Ads From a Database Using the AdRotator Web Server Control

How to: Select Ads in an AdRotator Web Server Control Programmatically

Walkthrough: Displaying and Tracking Advertisements with the AdRotator Control

Class Reference

The following table lists the classes that relate to the AdRotator control.




The main class for the control.


Represents the method that handles the AdCreated event of an AdRotator control.


Provides data for the AdCreated event of the AdRotator control.

Back to top

See Also

Other Resources

Working with ASP.NET Web Server Controls