System.Web.UI.WebControls (system.web.dll)class

The AdRotator class allows you to provide one of the hallmarks of the Internet: banner ads. The AdRotator randomly chooses a different graphic to display every time the page is refreshed by reading from a list of entries specified in an XML file (and referenced by the AdvertisementFile property). The XML file specifies details like image URL, the link URL, and an "impressions" value that allows you to weigh an advertisement so that it is displayed more or less frequently than others in the file. If the picture does not fit the size or aspect ratio of the control, it will be stretched, compressed, or otherwise mangled to fit.

The Target property allows you to specify the frame that will be used to display the linked page if the user clicks on a banner ad. You can specify a frame in the current window, or you can use special values like "_blank", "_parent", "_top", or "_self". The KeywordFilter property allows you to specify a subset of advertisements to use for the AdRotator. For example, your site could use a single XML file for all ads, but assign different keywords to different types of ads. Depending on what page the AdRotator is used on, you can decide to use only the group of advertisements that matches the current content.

Clicking on the AdRotator does not fire an event, but automatically transfers the users to the appropriate page. Use the AdCreated event to integrate the current page with the current advertisement. This event provides information in an AdCreatedEventArgs object about the selected ad, which can be modified or used to set corresponding properties on other controls on the current page.

public class AdRotator : WebControl {
// Public Constructors
   public AdRotator( );
// Public Instance Properties
   public string AdvertisementFile{set; get; }
   public override FontInfo Font{get; }             // overrides WebControl
   public string KeywordFilter{set; get; }
   public string Target{set; get; }
// Protected Instance Methods
   protected override ControlCollection CreateControlCollection( ); // overrides System.Web.UI.Control
   protected virtual void OnAdCreated(AdCreatedEventArgs e);
   protected override void OnPreRender(EventArgs e);            // overrides System.Web.UI.Control
   protected override void Render(System.Web.UI.HtmlTextWriter writer);  // overrides WebControl
// Events
   public event AdCreatedEventHandler AdCreated;


System.Object System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) WebControl(System.Web.UI.IAttributeAccessor) AdRotator

Returned By

System.Web.UI.MobileControls.AdRotator.CreateWebAdRotator( )

    Part I: Introduction to ASP.NET
    Part III: Namespace Reference
    Chapter 40. The System.Web.UI.MobileControls Namespace
    Chapter 42. The System.Web.UI.WebControls Namespace