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

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

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

AdRotator.AdvertisementFile プロパティ

広告データを含む XML ファイルへのパスを取得または設定します。既定値は空の文字列 ("") です。

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

Visual Basic (宣言)

<BindableAttribute(True)> _
Public Property AdvertisementFile As
 String

Visual Basic (使用法)

Dim instance As AdRotator
Dim value As String

value = instance.AdvertisementFile

instance.AdvertisementFile = value

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

C++

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

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

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

JScript

public function get AdvertisementFile
 () : String

public function set AdvertisementFile
 (value : String)

プロパティ値
AdRotator コントロール内にレンダリングする広告のプロパティを格納している XML ファイルのパス。

メモ
セキュリティ上の理由から、XML ファイルは App_Data フォルダに配置してください。このフォルダは、ユーザーが XML ファイルに直接アクセスできないように構成されています。

解説

ファイル形式およびファイル名の制限事項は、AdRotator.AdvertisementFile プロパティの制限事項に準拠しています。

プラットフォーム

バージョン情報

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

参照

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

AdRotator.AdvertisementFile プロパティ

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

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

Visual Basic (宣言)

<BindableAttribute(True)> _
Public Property AdvertisementFile As
 String

Visual Basic (使用法)

Dim instance As AdRotator
Dim value As String

value = instance.AdvertisementFile

instance.AdvertisementFile = value

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

C++

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

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

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

JScript

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	ピクセル単位のイメージの幅 (省略可能)。
NavigateUrl	AdRotator コントロールがクリックされたときの移動先 URL。
AlternateText	イメージが使用できないときに表示されるテキスト。ブラウザによっては、このテキストはツールヒントとして表示されます。
Keyword	広告のカテゴリ。AdRotator コントロールはこの属性を使用し、特定のカテゴリで広告一覧をフィルタ処理します。
Impressions	XML ファイル内の他の広告に対し各広告が表示される頻度を示す値。

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

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

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

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

広告ファイルを Data ディレクトリに格納します。このディレクトリは、任意の種類のファイルについてインターネットアクセスを拒否するための Machine.config で設定されています。
.xml 以外の拡張子でファイルの名前を変更し、その拡張子を Web.config の HttpForbiddenHandler に割り当てます。詳細については、Machine.config ファイルの httpHandlers 要素 (ASP.NET 設定スキーマ) のセクションを参照してください。

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

使用例

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

Visual Basic

<%@ 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>

JScript

<%@ 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 広告ファイルのファイル形式のコード例を次に示します。

<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>