AdRotator.AdvertisementFile プロパティ

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

広告情報を含む 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

プロパティ値

String

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

属性: BindableAttribute

例

次のコード例では、プロパティを使用 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 セクションを参照してください。

適用対象

次の方法で共有

AdRotator.AdvertisementFile プロパティ

定義

プロパティ値

例

注釈

適用対象

こちらもご覧ください

その他のリソース