AdRotator.AdvertisementFile プロパティ

定義

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

public:
 property System::String ^ AdvertisementFile { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string AdvertisementFile { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.AdvertisementFile : string with get, set
Public Property AdvertisementFile As String

プロパティ値

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

属性

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

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

次のコード例は、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>  

注釈

プロパティを AdvertisementFile 使用して、アドバタイズ情報を含む XML ファイルの場所を指定します。 XML ファイルは、同じ Web サイト内に存在する必要があります。 展開とセキュリティを目的として、同じ Web アプリケーションにファイルを配置することを強くお勧めします。 アプリケーションが十分な信頼を持っている場合にのみ、同じサイト上の別のアプリケーションにある XML ファイルにアクセスできます。

このプロパティは、絶対パスまたは XML ファイルに対する相対パスに設定できます。 デプロイを簡略化するには、相対パスを使用します。 相対パスを使用する場合、そのパスは、コントロールを含むページまたはユーザー コントロールの場所を基準にした AdRotator 相対パスになります。

AdvertisementFile プロパティは省略可能です。 イベントでは、アドバタイズをプログラムで AdCreated 設定することもできます。

XML ファイルには、次の定義済みの属性が含まれています。 ImageUrl属性のみが必要です。

属性 説明
ImageUrl 表示する画像の URL。
Height 画像の高さ (ピクセル単位) (省略可能)。
Width 画像の幅をピクセル単位で指定します (省略可能)。
NavigateUrl コントロールがクリックされたときに移動するページの AdRotator URL。
AlternateText 画像が使用できない場合に表示するテキスト。 一部のブラウザーでは、このテキストはツールヒントとして表示されます。
Keyword 広告のカテゴリ。 これは、特定のカテゴリの AdRotator アドバタイズの一覧をフィルター処理するためにコントロールによって使用されます。
Impressions XML ファイル内の他のアドバタイズに関連してアドバタイズが表示される頻度を示す 値。

Note

属性と NavigateUrl 属性にはImageUrl、完全な URL、ルート相対パス、または相対パスを指定できます。 ルート相対パスを使用する場合、パスは同じ Web サイトに対する相対パスになります。 相対パスを使用する場合、パスはアドバタイズ ファイルを含むディレクトリに対する相対パスになります。

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

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

未承認のインターネット アクセスから広告ファイルをセキュリティで保護するには、次のいずれかの操作を行います。

  • データ ディレクトリに格納します。これは、任意の種類のファイルのインターネット アクセスを拒否するようにMachine.configで構成されています。
  • .xmlされていない拡張子でファイルの名前を変更し、拡張子を Web.config で に HttpForbiddenHandler マップします。詳細については、Machine.config ファイルの httpHandlers セクションを参照してください。

適用対象

こちらもご覧ください