AdRotator.KeywordFilter AdRotator.KeywordFilter AdRotator.KeywordFilter AdRotator.KeywordFilter Property

Definition

Ruft ein Kategorieschlüsselwort zum Filtern nach bestimmten Werbungstypen in der XML-Datei für die Werbung ab oder legt dieses fest.Gets or sets a category keyword to filter for specific types of advertisements in the XML advertisement file.

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

Eigenschaftswert

Das Schlüsselwort zum Filtern nach bestimmten Werbungstypen in der XML-Datei für die Werbung.The keyword to filter for specific types of advertisements in the XML advertisement file. Der Standardwert ist eine leere Zeichenfolge („“).The default value is an empty string ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die KeywordFilter -Eigenschaft verwendet wird, um nach spielbezogenen Ankündigungen zu filtern.The following code example demonstrates how to use the KeywordFilter property to filter for game-related advertisements.

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

Im folgenden Codebeispiel wird veranschaulicht, wie ein Schlüsselwort für jede Ankündigung in der XML-Ankündigungs Datei angegeben wird.The following code example demonstrates how to specify a keyword for each advertisement in the XML advertisement file. Weitere Informationen zum Dateiformat finden Sie unter dem AdvertisementFile -Member.For more information on the file format, see the AdvertisementFile member.

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

Hinweise

Jeder Ankündigung in der XML-Ankündigungs Datei kann ein Kategorieschlüsselwort zugewiesen werden.Each advertisement in the XML advertisement file can be assigned a category keyword. Verwenden Sie KeywordFilter die-Eigenschaft, um die Ankündigungen für das angegebene Schlüsselwort zu filtern.Use the KeywordFilter property to filter the advertisements for the specified keyword. Nur Ankündigungen, die das Schlüsselwort enthalten, werden AdRotator für das Steuerelement ausgewählt.Only advertisements containing the keyword will be selected for the AdRotator control. Die KeywordFilter -Eigenschaft kann Programm gesteuert so festgelegt werden, dass Sie dem Profil des Benutzers entspricht.The KeywordFilter property can be programmatically set to match the profile of the user.

Die KeywordFilter -Eigenschaft ist ein sehr einfacher Filter, der nach dem angegebenen Schlüsselwort sucht.The KeywordFilter property is a very simple filter that searches for the specified keyword. Es ist nicht möglich, mehr als ein-Schlüsselwort in KeywordFilter der-Eigenschaft anzugeben, und es ist nicht möglich, mehrere Schlüsselwörter in der Ankündigungs Datei zu deklarieren.It is not possible to specify more than one keyword in the KeywordFilter property, nor is it possible to declare multiple keywords in the advertisement file.

Hinweis

Die AdvertisementFile -Eigenschaft muss für diese Eigenschaft festgelegt werden, damit Sie wirksam wird.The AdvertisementFile property needs to be set for this property to have any effect.

Achtung

Wenn das angegebene Schlüsselwort nicht in der XML-Ankündigungs Datei gefunden wird, wird im AdRotator Steuerelement keine Ankündigung angezeigt.If the specified keyword is not found in the XML advertisement file, no advertisement is displayed in the AdRotator control. Stellen Sie sicher, dass Sie ein Schlüsselwort für diese Eigenschaft angeben, das mindestens eine Entsprechung in der Ankündigungs Datei hat.Be sure to specify a keyword for this property with at least one match in the advertisement file.

Gilt für:

Siehe auch