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

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

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

AdRotator.KeywordFilter プロパティ

広告ファイルから広告をフィルタ処理する際に使用できるカテゴリキーワードを取得または設定します。既定値は空の文字列 ("") です。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As AdRotator
Dim value As String

value = instance.KeywordFilter

instance.KeywordFilter = value

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

C++

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

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

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

JScript

public function get KeywordFilter
 () : String

public function set KeywordFilter
 (value : String)

プロパティ値
特定のカテゴリ内で広告を識別する際に使用するキーワード。

解説

AdvertisementFile プロパティにデータがあり、この KeywordFilter プロパティに内容が含まれている場合、AdRotator コントロールは、キーワードが一致する広告を選択します。

AdvertisementFile プロパティにデータがあり、この KeywordFilter プロパティに内容が含まれていても、このプロパティとファイルとの間で一致するキーワードがない場合は、空白のイメージが表示され、トレース警告が生成されます。

使用例

KeywordFilter プロパティを使用して、AdvertisementFile プロパティで参照されているファイル内のイメージのコレクションからイメージをフィルタ処理するためのキーワードを設定する方法を次のコード例に示します。より詳しいコード例については、AdRotator クラスの概要を参照してください。

Visual Basic

<!-- The AdRotator control -->
<mobile:AdRotator id="AdControl" runat="server"
    ImageKey="MobileImgSrc" NavigateUrlKey="TargetUrl"
    AdvertisementFile="App_Data/ads.xml" Alignment="Left"
 
    KeywordFilter="Developer" OnAdCreated="AdCreated_Event">
    <DeviceSpecific>
        <Choice Filter="isWML11" NavigateUrlKey="WmlTargetUrl"
 
            ImageKey= "WmlImageSrc" />
    </DeviceSpecific>
</mobile:AdRotator>

<!-- The AdRotator control -->
<mobile:AdRotator id="AdControl" runat="server"
    ImageKey="MobileImgSrc" NavigateUrlKey="TargetUrl"
    AdvertisementFile="App_Data/ads.xml" Alignment="Left" 
    KeywordFilter="Developer" OnAdCreated="AdCreated_Event">
    <DeviceSpecific>
        <Choice Filter="isWML11" NavigateUrlKey="WmlTargetUrl"
 
            ImageKey= "WmlImageSrc" />
    </DeviceSpecific>
</mobile:AdRotator>

プラットフォーム

バージョン情報

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

参照

関連項目
AdRotator クラス
AdRotator メンバ
System.Web.UI.MobileControls 名前空間
System.Web.UI.WebControls.AdRotator
その他の技術情報
AdRotator コントロールの概要
<Choice> 要素 (.NET Framework 開発者ガイド)

AdRotator.KeywordFilter プロパティ

XML 広告ファイル内の特定のタイプの広告をフィルタ処理するためのカテゴリキーワードを取得または設定します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As AdRotator
Dim value As String

value = instance.KeywordFilter

instance.KeywordFilter = value

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

C++

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

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

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

JScript

public function get KeywordFilter
 () : String

public function set KeywordFilter
 (value : String)

プロパティ値
XML 広告ファイル内の特定のタイプの広告をフィルタ処理するためのキーワード。既定値は空の文字列 ("") です。

解説

XML 広告ファイル内の各広告に、1 つのカテゴリキーワードを割り当てることができます。KeywordFilter プロパティを使用して、指定されたキーワードの広告をフィルタ処理します。指定されたキーワードを含む広告だけが AdRotator コントロールで選択されます。KeywordFilter プロパティは、プログラムからユーザーのプロファイルと一致するように設定できます。

KeywordFilter プロパティは、指定したキーワードを検索する、単純なフィルタです。KeywordFilter プロパティには複数のキーワードを指定できず、また、広告ファイルで複数のキーワードを宣言することもできません。

注意
指定したキーワードが XML 広告ファイル内で見つからない場合、AdRotator コントロールに広告は表示されません。このプロパティには、広告ファイルで少なくとも 1 回は一致するキーワードを指定してください。

使用例

KeywordFilter プロパティを使用して、ゲーム関連の広告をフィルタする方法のコード例を次に示します。

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"
            KeywordFilter="Games"
            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"
            KeywordFilter="Games"
            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"
            KeywordFilter="Games"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

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>Business</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>Games</Keyword>
    <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
</Advertisements>