AdRotator.AdCreatedとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

AdRotator.AdCreated イベント

広告が表示されるたびに発生します。

名前空間: System.Web.UI.MobileControls
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文

Visual Basic (宣言)

Public Event AdCreated As
 AdCreatedEventHandler

Visual Basic (使用法)

Dim instance As AdRotator
Dim handler As AdCreatedEventHandler

AddHandler instance.AdCreated, handler

public event AdCreatedEventHandler AdCreated

C++

public:
event AdCreatedEventHandler^ AdCreated {
    void add (AdCreatedEventHandler^ value);
    void remove (AdCreatedEventHandler^ value);
}

/** @event */
public void add_AdCreated (AdCreatedEventHandler
 value)

/** @event */
public void remove_AdCreated (AdCreatedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

AdvertisementFile プロパティが設定されている場合、広告がファイルから選択された後、このイベントは発生します。

イベントハンドラは、表示されている広告のプロパティが格納されている AdCreatedEventArgs プロパティを受け取ります。このイベント固有の情報を提供するプロパティを次の表に示します。

プロパティ	説明
AdProperties	AdCreated イベントの発生後に XML ファイルから抽出されたすべての広告プロパティを格納しているディクショナリを返します。
AlternateText	AdRotator コントロール内にレンダリングする代替テキストおよび (ブラウザでサポートされている場合は) ツールヒントを指定します。
ImageUrl	AdRotator コントロール内にレンダリングするイメージを指定します。
NavigateUrl	広告をクリックしたときにブラウザが移動する URL 参照を指定します。

使用例

AdCreated イベントを処理する次のコード例は、AdRotator クラスの概要で取り上げているコード例の一部です。

Visual Basic

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

private void AdCreated_Event(Object sender,
 AdCreatedEventArgs e)
{
   Label2.Text = "Clicking the AdRotator control takes you to " + 
       e.NavigateUrl;
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
AdRotator クラス
AdRotator メンバ
System.Web.UI.MobileControls 名前空間
System.Web.UI.WebControls.AdRotator
その他の技術情報
AdRotator コントロールの概要

AdRotator.AdCreated イベント

作成されたコントロールがぺージ上に表示されるまでの間、サーバーへのラウンドトリップごとに 1 回発生します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Event AdCreated As
 AdCreatedEventHandler

Visual Basic (使用法)

Dim instance As AdRotator
Dim handler As AdCreatedEventHandler

AddHandler instance.AdCreated, handler

public event AdCreatedEventHandler AdCreated

C++

public:
event AdCreatedEventHandler^ AdCreated {
    void add (AdCreatedEventHandler^ value);
    void remove (AdCreatedEventHandler^ value);
}

/** @event */
public void add_AdCreated (AdCreatedEventHandler
 value)

/** @event */
public void remove_AdCreated (AdCreatedEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、作成されたコントロールがページ上に表示されるまでの間、サーバーへのラウンドトリップごとに 1 回発生します。AdvertisementFile プロパティが設定されている場合、このイベントは広告がファイルから選択された後で発生します。

AdCreated イベントのイベントハンドラに渡された引数を変更することにより、AdRotator コントロールがどのように表示されるかを制御できます。AdvertisementFile プロパティが設定されていない場合は、別の広告ファイルを使用せずに、広告情報を直接指定できます。AdvertisementFile プロパティが設定されている場合は、別のページへのリダイレクトなど、AdRotator コントロールの動作を拡張できます。

メモ
ページキャッシュが有効な場合、AdRotator コントロールはキャッシュされません。Web ページが更新されるたびに、新しい広告が選択されます。ただし、AdCreated イベントのイベントハンドラが提供されている場合は、新しい広告は選択されません。

イベント処理の詳細については、「イベントの処理と発生」を参照してください。

Topic	Location
方法 : AdRotator Web サーバーコントロールでプログラムによって広告を選択する	ASP .NET Web アプリケーションの作成

使用例

AdCreated イベントのハンドラを指定およびコーディングする方法を次のコード例に示します。この例では、AdRotator コントロールが作成されたときに広告に関連付けられた URL を取得して、次にその URL を表示します。

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<html>
 <head>
 
 </head>
 
    <script language="VB" runat="server">
       Sub AdCreated_Event(sender As Object,
 e As AdCreatedEventArgs) 
          Message.Text=e.NavigateUrl
       End Sub
    </script>
 
 <body>
 
    <form runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="test1" runat="server"
            AdvertisementFile = "~/App_Data/Ads.xml"
            Borderwidth="1"
            Target="_blank"
            OnAdCreated="AdCreated_Event"/><br><br>
 
       <asp:label id="Message" runat="server"/>
 
    </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="C#" runat="server">
       void AdCreated_Event(Object sender, AdCreatedEventArgs
 e) 
       {
          Message.Text=e.NavigateUrl;   
       }      
    </script>
 
 <body>
 
    <form runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="test1" runat="server"
            AdvertisementFile = "~/App_Data/Ads.xml"
            Borderwidth="1"
            Target="_blank"
            OnAdCreated="AdCreated_Event"/><br><br>
 
       <asp:label id="Message" runat="server"/>
 
    </form>
 
 </body>
 </html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <head>
 
 </head>
 
    <script language="JScript" runat="server">
       function AdCreated_Event(sender, e : AdCreatedEventArgs)
 
       {
          Message.Text=e.NavigateUrl;   
       }      
    </script>
 
 <body>
 
    <form runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="test1" runat="server"
            AdvertisementFile = "~/App_Data/Ads.xml"
            Borderwidth="1"
            Target="_blank"
            OnAdCreated="AdCreated_Event"/><br><br>
 
       <asp:label id="Message" runat="server"/>
 
    </form>
 
 </body>
 </html>

広告情報を含む XML ファイルの書式を設定する方法を次のコード例に示します。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>
    <Caption>This is the caption for Ad#1</Caption> 
  </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>
    <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
</Advertisements>

メモ
次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .aspx の空のテキストファイルにコピーする必要があります。Web フォームのコードモデルの詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<html>
<head>
 
</head>
 
   <script runat="server">

      Sub Page_Load(sender As Object,
 e As EventArgs)

         ' Create an EventHandler delegate for the method you want to
 handle the event
         ' and then add it to the list of methods called when the event
 is raised.
         AddHandler Ad.AdCreated, AddressOf
 AdCreated_Event

      End Sub

      Sub AdCreated_Event(sender As Object,
 e As AdCreatedEventArgs) 

         ' Override the AlternateText value from the ads.xml file.
         e.AlternateText = "Visit this site!"   

      End Sub      

   </script>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator AdCreated Example</h3>

      Notice that the AlternateText property of
 the advertisement <br>
      has been programmatically modified from the value in the
 XML <br>
      file. 

      <br><br>
 
      <asp:AdRotator id="Ad" runat="server"
           AdvertisementFile = "~/App_Data/Ads.xml"
           Borderwidth="1"
           Target="_blank"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>
 
</head>
 
   <script runat="server">

      void Page_Load(Object sender, EventArgs e)
      {

         // Create an EventHandler delegate for the method you want
 to handle the event
         // and then add it to the list of methods called when the event
 is raised.
         Ad.AdCreated += new System.Web.UI.WebControls.AdCreatedEventHandler(this.AdCreated_Event);

      }

      void AdCreated_Event(Object sender, AdCreatedEventArgs e)
 
      {

         // Override the AlternateText value from the ads.xml file.
         e.AlternateText = "Visit this site!";   

      }      

   </script>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator AdCreated Example</h3>

      Notice that the AlternateText property of the advertisement <br>
      has been programmatically modified from the value in the
 XML <br>
      file. 

      <br><br>
 
      <asp:AdRotator id="Ad" runat="server"
           AdvertisementFile = "~/App_Data/Ads.xmla"
           Borderwidth="1"
           Target="_blank"/>
 
   </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
AdRotator クラス
AdRotator メンバ
System.Web.UI.WebControls 名前空間
OnAdCreated
AdCreatedEventHandler デリゲート
AdCreatedEventArgs クラス
その他の技術情報
AdRotator Web サーバーコントロール