The AdRotator control randomly selects banner graphics from a list, which is specified in an external XML schedule file.
This external XML schedule file is called the advertisement file.
<asp:AdRotator runat = "server" AdvertisementFile = "adfile.xml" Target = "_blank" />
The advertisement file is an XML file, which contains the information about the advertisements to be displayed.
There are the following standard XML elements that are commonly used in the advertisement file:
|Advertisements||Encloses the advertisement file.|
|Ad||Delineates separate ad.|
|ImageUrl||The path of image that will be displayed.|
|NavigateUrl||The link that will be followed when the user clicks the ad.|
|AlternateText||The text that will be displayed instead of the picture if it cannot be displayed.|
|Keyword||Keyword identifying a group of advertisements. This is used for filtering.|
|Impressions||The number indicating how often an advertisement will appear.|
|Height||Height of the image to be displayed.|
|Width||Width of the image to be displayed.|
Apart from these tags, customs tags with custom attributes could also be included. The following code illustrates an advertisement file ads.xml:
fl1.jpg http://www.fastlearning.in Order flowers, roses, gifts and more 20 Learn
The AdRotator class is derived from the WebControl class and inherits its properties.
|AdvertisementFile||The path to the advertisement file.|
|AlternateTextFeild||The element name of the field where alternate text is provided. The default value is AlternateText.|
|DataMember||The name of the specific list of data to be bound when advertisement file is not used.|
|DataSource||Control from where it would retrieve data.|
|DataSourceID||Id of the control from where it would retrieve data.|
|Font||Specifies the font properties associated with the advertisement banner control.|
|ImageUrlField||The element name of the field where the URL for the image is provided. The default value is ImageUrl.|
|KeywordFilter||For displaying the keyword based ads only.|
|NavigateUrlField||The element name of the field where the URL to navigate to is provided. The default value is NavigateUrl.|
|Target||The browser window or frame that displays the content of the page linked.|
|UniqueID||Obtains the unique, hierarchically qualified identifier for the AdRotator control.|
The important events of the AdRotator class:
|AdCreated||It is raised once per round trip to the server after creation of the control, but before the page is rendered|
|DataBinding||Occurs when the server control binds to a data source.|
|DataBound||Occurs after the server control binds to a data source.|
|Disposed||Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested|
|Init||Occurs when the server control is initialized, which is the first step in its lifecycle.|
|Load||Occurs when the server control is loaded into the Page object.|
|PreRender||Occurs after the Control object is loaded but prior to rendering.|
|Unload||Occurs when the server control is unloaded from memory.|
Create a new web page and place an AdRotator control on it.