AdRotator.ImageKey Property
Returns the element name from which the image URL is retrieved from an advertisement. The default value is "ImageUrl". This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site. This API is obsolete. For information about how to develop ASP.NET mobile applications, see the www.asp.net/mobile Web site.
Assembly: System.Web.Mobile (in System.Web.Mobile.dll)
Property Value
Type: System.StringThe element name from which the image URL is retrieved for an advertisement.
You can create elements in the source XML file for a variety of purposes. For example, you may want to use the same XML file for both mobile pages and Web pages, but want a different image file for each one. Use the ImageKey property to specify which element in your XML file you want to use for the image URL.
You can also use separate <Choice> elements to override this setting to show alternate images for the advertisement.
The following code example demonstrates how to use the ImageKey property to select a specific item from a record in the XML file. This .aspx file specifies that the value for the image URL can be obtained from the <MobileImageSrc> element of the XML file, and uses a <Choice> element to select a different image URL if the user's browser requires WML markup.
The .aspx file:
<%@ Page Language="VB" Inherits="System.Web.UI.MobileControls.MobilePage" %> <%@ Register TagPrefix="mobile" Namespace="System.Web.UI.MobileControls" %> <%@ Import Namespace="System.Web.Mobile" %> <script runat="server"> Private Sub AdCreated_Event(ByVal sender As Object, _ ByVal e As AdCreatedEventArgs) Label2.Text = "Clicking the AdRotator control takes you to " + _ e.NavigateUrl End Sub ' Determine whether the current browser is a WML brower. Public Function isWml11(ByVal caps As MobileCapabilities, _ ByVal value As String) As Boolean If Not caps.Crawler AndAlso caps.PreferredRenderingMime = _ MobileCapabilities.PreferredRenderingTypeWml11 Then Return True Else Return False End If End Function </script> <html xmlns="http://www.w3.org/1999/xhtml" > <body> <mobile:form id="form1" runat="server"> <!-- The AdRotator control --> <mobile:AdRotator id="AdControl" runat="server" ImageKey="MobileImgSrc" NavigateUrlKey="TargetUrl" AdvertisementFile="App_Data/ads.xml" Alignment="Left" KeywordFilter="Developer" OnAdCreated="AdCreated_Event"> <DeviceSpecific> <Choice Filter="isWML11" NavigateUrlKey="WmlTargetUrl" ImageKey= "WmlImageSrc" /> </DeviceSpecific> </mobile:AdRotator> <!-- The instructions label --> <mobile:Label id="Label1" runat="server" Text="Refresh the page to change the advertisement" /> <!-- The URL info label --> <mobile:Label id="Label2" runat="server" /> </mobile:form> </body> </html>
The sample ads.xml file (which must be located in the App_Data folder):
<?xml version="1.0" encoding="utf-8" ?> <Advertisements> <Ad> <WebImgSrc>imgA1.gif</WebImgSrc> <MobileImgSrc>imgA2.gif</MobileImgSrc> <WmlImgSrc>imgA3.gif</WmlImgSrc> <TargetUrl>http://msdn.microsoft.com/</TargetUrl> <WmlTargetUrl>http://OurServer/MS-MSDN.wml</WmlTargetUrl> <AlternateText>MSDN</AlternateText> <Keyword>Developer</Keyword> <Impressions>80</Impressions> </Ad> <Ad> <WebImgSrc>imgB1.gif</WebImgSrc> <MobileImgSrc>imgB2.gif</MobileImgSrc> <WmlImgSrc>imgB3.gif</WmlImgSrc> <TargetUrl>http://www.microsoft.com/</TargetUrl> <WmlTargetUrl>http://OurServer/MS-Home.wml</WmlTargetUrl> <AlternateText>Microsoft</AlternateText> <Keyword>Customer</Keyword> <Impressions>90</Impressions> </Ad> <Ad> <WebImgSrc>imgC1.gif</WebImgSrc> <MobileImgSrc>imgC2.gif</MobileImgSrc> <WmlImgSrc>imgC3.gif</WmlImgSrc> <TargetUrl>http://www.microsoft.com/net/</TargetUrl> <WmlTargetUrl>http://OurServer/MS-Net.wml</WmlTargetUrl> <AlternateText>.NET</AlternateText> <Keyword>Developer</Keyword> <Impressions>80</Impressions> </Ad> </Advertisements>
Available since 1.1
System.Web.UI.WebControls.AdRotator
ImageKey
AdRotator Class
System.Web.UI.MobileControls Namespace
Introduction to the AdRotator Control
<Choice> Element