Freigeben über


AdRotator.KeywordFilter-Eigenschaft

Ruft ein Kategorieschlüsselwort zum Filtern nach bestimmten Werbungstypen in der XML-Datei für die Werbung ab oder legt dieses fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<BindableAttribute(True)> _
Public Property KeywordFilter As String
'Usage
Dim instance As AdRotator
Dim value As String

value = instance.KeywordFilter

instance.KeywordFilter = value
[BindableAttribute(true)] 
public string KeywordFilter { get; set; }
[BindableAttribute(true)] 
public:
property String^ KeywordFilter {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_KeywordFilter ()

/** @property */
public void set_KeywordFilter (String value)
public function get KeywordFilter () : String

public function set KeywordFilter (value : String)

Eigenschaftenwert

Das Schlüsselwort zum Filtern nach bestimmten Werbungstypen in der XML-Datei für die Werbung. Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Jeder Werbung in der XML-Datei für die Werbung kann ein Kategorieschlüsselwort zugeordnet werden. Filtern Sie mit der KeywordFilter-Eigenschaft die Werbungen nach dem angegebenen Schlüsselwort. Nur Werbungen, die das Schlüsselwort enthalten, werden für das AdRotator-Steuerelement ausgewählt. Die KeywordFilter-Eigenschaft kann programmgesteuert so festgelegt werden, dass sie dem Profil des Benutzers entspricht.

Die KeywordFilter-Eigenschaft ist ein sehr einfacher Filter zur Suche nach dem angegebenen Schlüsselwort. In der KeywordFilter-Eigenschaft kann immer nur ein Schlüsselwort angegeben werden. Auch in der Datei für die Werbung kann immer nur ein Schlüsselwort deklariert sein.

Hinweis

Damit diese Eigenschaft wirksam wird, muss die AdvertisementFile-Eigenschaft festgelegt werden.

Warnung

Im AdRotator-Steuerelement wird keine Werbung angezeigt, wenn in der XML-Datei das angegebene Schlüsselwort nicht gefunden wird. Geben Sie für diese Eigenschaft ein Schlüsselwort an, das mindestens einmal in der Datei für die Werbung enthalten ist.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der KeywordFilter-Eigenschaft nach spielbezogenen Werbungen gefiltert werden kann.

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

Im folgenden Codebeispiel wird das Angeben eines Schlüsselworts für jede Werbung in der XML-Datei für die Werbung veranschaulicht. Weitere Informationen über das Dateiformat finden Sie unter dem AdvertisementFile-Member.

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AdRotator-Klasse
AdRotator-Member
System.Web.UI.WebControls-Namespace
AdRotator.AdvertisementFile-Eigenschaft

Weitere Ressourcen

AdRotator-Webserver-Steuerelement