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.Web.UI.Control(System.ComponentModel.IComponent,
System.IDisposable,
System.Web.UI.IParserAccessor,
System.Web.UI.IDataBindingsAccessor)