AdRotator.AdvertisementFile プロパティ

  • [アーティクル]

広告情報を含む XML ファイルのパスを取得または設定します。

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

構文

'宣言
<BindableAttribute(True)> _
Public Property AdvertisementFile As String
'使用
Dim instance As AdRotator
Dim value As String

value = instance.AdvertisementFile

instance.AdvertisementFile = value

[BindableAttribute(true)] 
public string AdvertisementFile { get; set; }

[BindableAttribute(true)] 
public:
property String^ AdvertisementFile {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_AdvertisementFile ()

/** @property */
public void set_AdvertisementFile (String value)

public function get AdvertisementFile () : String

public function set AdvertisementFile (value : String)

適用できません。

プロパティ値

広告情報を含む XML ファイルの場所。既定値は空の文字列 ("") です。

解説

AdvertisementFile プロパティを使用して、広告情報を含む XML ファイルの場所を指定します。この XML ファイルは、同じ Web サイトにある必要があります。配置とセキュリティを考慮して、このファイルを同じ Web アプリケーションに置くことを強くお勧めします。同じサイト上の異なるアプリケーションにある XML ファイルにアクセスできるのは、そのアプリケーションの完全な信頼がある場合だけです。

このプロパティは、XML ファイルへの絶対パスまたは相対パスに設定できます。相対パスを使用すると配置が簡単です。相対パスを使用する場合は、AdRotator コントロールを含んでいるページまたはユーザー コントロールからの相対パスになります。

AdvertisementFile プロパティは省略可能です。広告は AdCreated イベントでプログラムから設定することもできます。

XML ファイルに格納されている定義済み属性を次に示します。ImageUrl 属性だけが必須項目です。

属性

説明

ImageUrl

表示するイメージの URL。

Height

ピクセル単位のイメージの高さ (省略可能)。

Width

ピクセル単位のイメージの幅 (省略可能)。

href

AdRotator コントロールがクリックされたときの移動先 URL。

AlternateText

イメージが使用できないときに表示されるテキスト。ブラウザによっては、このテキストはツールヒントとして表示されます。

Keyword

広告のカテゴリ。AdRotator コントロールはこの属性を使用し、特定のカテゴリで広告一覧をフィルタ処理します。

Impressions

XML ファイル内の他の広告に対し各広告が表示される頻度を示す値。
メモメモ :

ImageUrl 属性と href 属性は、フル URL、ルート相対パス、相対パスのいずれかになります。ルート相対パスを使用する場合は、同じ Web サイトからの相対パスになります。相対パスを使用する場合は、広告ファイルがあるディレクトリからの相対パスになります。

XML ファイルでカスタム タグを使用し、カスタム属性を含めることもできます。すべての属性タグが広告ファイルで解析され、値が AdProperties ディクショナリに書き込まれます。AdProperties ディクショナリを使用すると、プログラムからカスタム属性にアクセスできます。

このファイルの中の情報は AdRotator コントロールで検証されません。広告によって悪意のあるスクリプトが実行されないようにするには、リリース前にデータを必ず検証するか、信頼されているソースからの広告情報だけを受け入れるようにする必要があります。

未承認のインターネット アクセスから広告ファイルを保護するには、次の 1 つ以上の操作を行います。

  • 広告ファイルを Data ディレクトリに格納します。このディレクトリは、任意の種類のファイルについてインターネット アクセスを拒否するための Machine.config で設定されています。

  • .xml 以外の拡張子でファイルの名前を変更し、その拡張子を Web.config の HttpForbiddenHandler に割り当てます。詳細については、Machine.config ファイルの httpHandlers 要素 (ASP.NET 設定スキーマ) のセクションを参照してください。

トピック 場所
チュートリアル : AdRotator コントロールを使用した広告の表示と追跡 Visual Studio での ASP .NET Web アプリケーションの作成
チュートリアル : AdRotator コントロールを使用した広告の表示と追跡 Visual Studio ASP .NET での Web アプリケーションの作成
チュートリアル : AdRotator コントロールを使用した広告の表示と追跡 Visual Studio ASP .NET での Web アプリケーションの作成

使用例

AdvertisementFile プロパティを使用して、広告情報を含む XML ファイルの場所を指定する方法のコード例を次に示します。

<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 
 <head runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" 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" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 
 <head runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" 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" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 
 <head runat="server">
    <title>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

XML 広告ファイルのファイル形式のコード例を次に示します。

<Advertisements>
  <Ad>
    <ImageUrl>~/Images/image1.jpg</ImageUrl>
    <Height>60</Height>
    <Width>190</Width>
    <href>https://www.microsoft.com</href>
    <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>
    <href>http://www.wingtiptoys.com</href>
    <AlternateText>Wingtip Toys</AlternateText>
    <Impressions>80</Impressions>
    <Keyword>Topic2</Keyword>
    <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
</Advertisements>

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

AdRotator クラス
AdRotator メンバ
System.Web.UI.WebControls 名前空間
AdCreated
AdCreatedEventArgs

その他の技術情報

AdRotator Web サーバー コントロール