AdRotator.Target Eigenschaft

Definition

Ruft den Namen des Fensters bzw. Frames im Browser ab, in dem der Inhalt der beim Klicken auf das AdRotator-Steuerelement aufgerufenen Webseite angezeigt wird, oder legt diesen fest.Gets or sets the name of the browser window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String

Eigenschaftswert

Das Fenster bzw. der Frame des Browsers, in dem der Inhalt der Webseite angezeigt wird, die beim Klicken auf das AdRotator-Steuerelement aufgerufen wird.The browser window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked. Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit dem Fokus aktualisiert.The default value is an empty string (""), which refreshes the window or frame with focus.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Target-Eigenschaft veranschaulicht.The following code example demonstrates how to use the Target property. Es zeigt den Inhalt der Webseite an, die mit verknüpft ist, wenn in einem neuen, nicht eingebundenen Fenster auf das AdRotator-Steuerelement geklickt wird.It displays the contents of the Web page linked to when the AdRotator control is clicked in a new, unframed window.

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

Im folgenden Codebeispiel wird das Dateiformat für eine XML-Datei veranschaulicht, die Ankündigungs Informationen enthält.The following code example demonstrates the file format for an XML file that contains advertisement information. 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>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>  

Hinweise

Verwenden Sie die Target-Eigenschaft, um das Zielfenster oder den Rahmen anzugeben, in dem der Inhalt der Webseite angezeigt wird, die beim Klicken auf das AdRotator Steuerelement verknüpft ist.Use the Target property to specify the target window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked.

Hinweis

Die Target-Eigenschaft wird als target Attribut gerendert.The Target property renders as a target attribute . Das target-Attribut für Anker Elemente (a) ist in XHTML 1,1 nicht zulässig.The target attribute on anchor (a) elements is not allowed in XHTML 1.1. Wenn gerendertes Markup den XHTML-Standards entsprechen muss oder den Barrierefreiheits Standards entsprechen muss, legen Sie die Target-Eigenschaft daher nicht fest.Therefore, if rendered markup must conform to XHTML standards or must conform to accessibility standards, do not set the Target property. Weitere Informationen finden Sie unter XHTML-Standards in Visual Studio und ASP.net und Barrierefreiheit in Visual Studio und ASP.net.For more information, see XHTML Standards in Visual Studio and ASP.NET and Accessibility in Visual Studio and ASP.NET.

Der Target-Wert muss mit einem Buchstaben im Bereich von a bis Z (ohne Beachtung der Groß-/Kleinschreibung) beginnen, mit Ausnahme der folgenden speziellen Werte, die mit einem Unterstrich beginnen.The Target value must begin with a letter in the range of A to Z (case-insensitive), except for the following special values, which begin with an underscore.

ZielwertTarget value BeschreibungDescription
_blank Stellt den Inhalt in einem neuen Fenster ohne Frames dar.Renders the content in a new window without frames.
_parent Stellt den Inhalt im unmittelbar übergeordneten Frameset dar.Renders the content in the immediate frameset parent.
_search Gibt den Inhalt im Suchbereich wieder.Renders the content in the search pane.
_self Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.Renders the content in the frame with focus.
_top Stellt den Inhalt im gesamten Fenster ohne Frames dar.Renders the content in the full window without frames.

Hinweis

Lesen Sie in der Browserdokumentation nach, ob der _search-Wert unterstützt wird.Check your browser documentation to determine whether the _search value is supported. Beispielsweise unterstützt Internet Explorer 5,0 oder höher den _search Zielwert.For example, Internet Explorer 5.0 or later supports the _search target value.

Gilt für:

Siehe auch