AdRotator イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | AdCreated | 広告が表示されるたびに発生します。 |
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照AdRotator イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
| | AdCreated | 作成されたコントロールがぺージ上に表示されるまでの間、サーバーへのラウンド トリップごとに 1 回発生します。 |
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | DataBound | サーバー コントロールがデータ ソースにバインドした後に発生します。 ( BaseDataBoundControl から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照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 コンストラクタ
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文解説System.Web.UI.MobileControls.AdRotator モバイル コントロールは、System.Web.UI.WebControls.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 クラスの新しいインスタンスを作成および初期化する方法を次のコード例に示します。その後、新しい AdRotator コントロールが PlaceHolder コントロールの Control.Controls コレクションに追加され、Web フォーム ページに表示されます。
| メモ |
|---|
| 次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォームのコード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Page_Load(sender As Object, e As EventArgs) ' Create an AdRotator control. Dim rotator As AdRotator = New AdRotator() ' Set the control's properties. rotator.AdvertisementFile = "~\App_Data\Ads.xml" ' Add the control to the Controls collection of a ' PlaceHolder control. myPlaceHolder.Controls.Add(rotator) End Sub </script> </head> <body> <form runat="server"> <h3>AdRotator Constructor Example</h3> <asp:Placeholder id=myPlaceHolder runat="server"/> </form> </body> </html>
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void Page_Load(Object sender, EventArgs e) { // Create an AdRotator control. AdRotator rotator = new AdRotator(); // Set the control's properties. rotator.AdvertisementFile = @"~\App_Data\Ads.xml"; // Add the control to the Controls collection of a // PlaceHolder control. myPlaceHolder.Controls.Add(rotator); } </script> </head> <body> <form runat="server"> <h3>AdRotator Constructor Example</h3> <asp:Placeholder id=myPlaceHolder runat="server"/> </form> </body> </html>
<%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script runat="server"> function Page_Load(sender, e : EventArgs) { // Create an AdRotator control. var rotator : AdRotator = new AdRotator(); // Set the control's properties. rotator.AdvertisementFile = "Ads.xml"; // Add the control to the Controls collection of a // PlaceHolder control. myPlaceHolder.Controls.Add(rotator); } </script> </head> <body> <form runat="server"> <h3>AdRotator Constructor Example</h3> <asp:Placeholder id=myPlaceHolder runat="server"/> </form> </body> </html>
プラットフォーム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 プロパティ
パブリック プロパティ.gif)
プロテクト プロパティ.gif)
参照AdRotator プロパティ
パブリック プロパティプロテクト プロパティ参照関連項目
AdRotator クラスSystem.Web.UI.WebControls 名前空間
AdCreatedEventArgs クラス
AdCreatedEventHandler デリゲート
AdvertisementFile
その他の技術情報
AdRotator Web サーバー コントロールAdRotator メソッド
パブリック メソッド.gif)
.gif)
プロテクト メソッド.gif)
参照AdRotator メソッド
パブリック メソッドプロテクト メソッド参照関連項目
AdRotator クラスSystem.Web.UI.WebControls 名前空間
AdCreatedEventArgs クラス
AdCreatedEventHandler デリゲート
AdvertisementFile
その他の技術情報
AdRotator Web サーバー コントロールAdRotator メンバ
ランダムに選択した広告をモバイル ページに表示するサーバー コントロールを提供します。
AdRotator データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | AdCreated | 広告が表示されるたびに発生します。 |
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
参照AdRotator メンバ
AdRotator データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | AdCreated | 作成されたコントロールがぺージ上に表示されるまでの間、サーバーへのラウンド トリップごとに 1 回発生します。 |
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | DataBound | サーバー コントロールがデータ ソースにバインドした後に発生します。(BaseDataBoundControl から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
参照関連項目
AdRotator クラスSystem.Web.UI.WebControls 名前空間
AdCreatedEventArgs クラス
AdCreatedEventHandler デリゲート
AdvertisementFile
その他の技術情報
AdRotator Web サーバー コントロール- AdRotatorのページへのリンク
