AdRotator クラス
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文解説AdRotator クラスは、Web フォームの AdRotator クラスと同じ構成ファイルを使用します。System.Web.UI.MobileControls.AdRotator モバイル コントロールは、System.Web.UI.WebControls.AdRotator コントロールと同じプロパティおよびイベントの多くを公開するだけではなく、モバイル機能を追加します。表示される広告は、ページを更新するたびに変わります。
AdvertisementFile プロパティは、広告情報が格納されている XML ファイルの場所を指定します。このファイルは、アプリケーション ドメイン内に存在する必要があります。セキュリティ上の理由から、XML ファイルは App_Data フォルダに配置してください。このフォルダは、ユーザーが XML ファイルに直接アクセスできないように構成されています。AdvertisementFile プロパティが空の場合、AdRotator コントロールは、1 つの改行タグをプレースホルダとして生成します。これは、広告を表示しない場合に役立ちます。
使用例次のコード例は、.aspx ファイルに記述された ASP.NET モバイル Web フォーム ページと XML ファイルという 2 つの部分で構成されています。.aspx ファイルは、ads.xml という名前のファイルを使用して、さまざまな広告を KeywordFilter プロパティに基づいて切り替えます。この例のイメージを提供すると、それらのイメージが表示されます。それ以外の場合、AdRotator コントロールは、広告の AlternateText プロパティの値を表示します。ユーザーがモバイル Web フォーム ページを更新すると、KeywordFilter に基づいて、ランダムに選択された次の広告がページに表示されます。
この例ではまた、ユーザーのブラウザで WML マークアップを必要とする場合に <Choice> 要素 (.NET Framework 開発者ガイド) 要素を使用してプロパティをオーバーライドする方法や、ImageKey プロパティと NavigateUrlKey プロパティを使用してそれぞれイメージの src 属性と href 属性を XML ファイル内のデータに割り当てる方法も示しています。
この例では、ブラウザが WML を必要とするかどうかを確認するために関数を使用していますが (isWML11)、代わりに Web.config ファイルを使用して、これを自動で確認するために .NET Framework が自動的に使用する DeviceSpecific 要素を定義することも可能です。
<deviceFilters> <filter name="isWML11" compare="PreferredRenderingType" argument="wml11" /> </deviceFilters>
.gif) メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ 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 > <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>
<%@ Page Language="C#" Inherits="System.Web.UI.MobileControls.MobilePage" %> <%@ Register TagPrefix="mobile" Namespace="System.Web.UI.MobileControls" %> <%@ Import Namespace="System.Web.Mobile" %> <script runat="server"> private void AdCreated_Event(Object sender, AdCreatedEventArgs e) { Label2.Text = "Clicking the AdRotator control takes you to " + e.NavigateUrl; } // Determine whether the current browser is a WML brower public bool isWML11(MobileCapabilities caps, string optValue) { // Determine if the browser is not a Web crawler and // requires WML markup if (!caps.Crawler && caps.PreferredRenderingType == MobileCapabilities.PreferredRenderingTypeWml11) return true; else return false; } </script> <html > <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>
サンプル ads.xml ファイル (App_Data フォルダに配置する必要があります)
<?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>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.MobileControls.MobileControl
System.Web.UI.MobileControls.AdRotator
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照AdRotator クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説AdRotator コントロールを使用して、選択した広告バナーを Web ページにランダムに表示します。表示される広告は、ページを更新するたびに変更されます。
広告情報は各 XML ファイルに格納されます。XML ファイルは、広告および広告に関連付けられている属性の一覧を維持します。属性には、表示するイメージのパス、コントロールがクリックされたときのリンク先 URL、イメージが使用できないときに表示される代替テキスト、キーワード、および広告の表示時間が含まれます。このファイルの中の情報は AdRotator コントロールで検証されません。広告によって悪意のあるスクリプトが実行されないようにするには、リリース前にデータを必ず検証するか、信頼されているソースからの広告情報だけを受け入れるようにする必要があります。
未承認のインターネット アクセスから広告ファイルを保護するには、次の 1 つ以上の操作を行います。
-
広告ファイルを App_Data ディレクトリに格納します。このディレクトリは、任意の種類のファイルについてインターネット アクセスを拒否するために設定されています。
-
.xml 以外の拡張子でファイルの名前を変更し、その拡張子を Web.config の HttpForbiddenHandler に割り当てます。詳細については、Machine.config ファイルの httpHandlers 要素 (ASP.NET 設定スキーマ) のセクションを参照してください。
XML ファイルに対するデータの代替ソースとして、コールバック イベントを通じて広告情報を提供できます。このイベントを XML ファイルと組み合わせて使用することで、他のページへのリダイレクトなどの AdRotator コントロールの動作を拡張することもできます。ファイル形式の詳細については、AdvertisementFile プロパティのトピックを参照してください。
それぞれの広告には Impressions 属性を割り当てることができます。この属性は、広告ファイル内の他の広告に対し各広告が選択される頻度を制御します。
| メモ |
|---|
| ページ キャッシュが有効な場合、AdRotator コントロールはキャッシュされません。Web ページが更新されるたびに、新しい広告が選択されます。ただし、AdCreated イベントのイベント ハンドラが提供されている場合は、新しい広告は選択されません。 |
| Topic | Location |
|---|---|
| チュートリアル : AdRotator コントロールを使用した広告の表示と追跡 | Visual Studio での ASP .NET Web アプリケーションの作成 |
| 方法 : AdRotator Web サーバー コントロールでプログラムによって広告を選択する | ASP .NET Web アプリケーションの作成 |
| 方法 : AdRotator Web サーバー コントロールを使用して XML ファイルから広告を表示する | ASP .NET Web アプリケーションの作成 |
| 方法 : AdRotator Web サーバー コントロールを使用してデータベースから広告を表示する | ASP .NET Web アプリケーションの作成 |
使用例AdRotator コントロールを使用して、Web ページに広告バナーを表示する方法のコード例を次に示します。
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> </head> <body> <form runat="server"> <h3>AdRotator Example</h3> <asp:AdRotator id="AdRotator1" runat="server" Target="_self" AdvertisementFile="~/App_Data/Ads.xml"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> </head> <body> <form runat="server"> <h3>AdRotator Example</h3> <asp:AdRotator id="AdRotator1" runat="server" Target="_self" AdvertisementFile="~/App_Data/Ads.xml"/> </form> </body> </html>
<%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> </head> <body> <form runat="server"> <h3>AdRotator Example</h3> <asp:AdRotator id="AdRotator1" runat="server" Target="_self" AdvertisementFile="~/App_Data/Ads.xml"/> </form> </body> </html>
前の例について、広告情報を含む XML ファイルのファイル形式のコード例を次に示します。ファイル形式の詳細については、AdvertisementFile メンバのトピックを参照してください。
<Advertisements> <Ad> <ImageUrl>~/Images/image1.jpg</ImageUrl> <height>60</height> <width>190</width> <NavigateUrl>http://www.microsoft.com</NavigateUrl> <AlternateText>Microsoft Main Site</AlternateText> <Impressions>80</Impressions> <Keyword>Topic1</Keyword> </Ad> <Ad> <ImageUrl>~/Images/image2.jpg</ImageUrl> <height>90</height> <width>90</width> <NavigateUrl>http://www.wingtiptoys.com</NavigateUrl> <AlternateText>Wingtip Toys</AlternateText> <Impressions>80</Impressions> <Keyword>Topic2</Keyword> </Ad> </Advertisements>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.BaseDataBoundControl
System.Web.UI.WebControls.DataBoundControl
System.Web.UI.WebControls.AdRotator
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- AdRotator クラスのページへのリンク
