Freigeben über

AdRotator.Target Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen des Namens des Browserfensters oder Frames, das den Inhalt der Webseite anzeigt, die verknüpft ist, wenn auf das AdRotator Steuerelement geklickt wird.

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; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Property Target As String

Eigenschaftswert

String

Das Browserfenster oder -frame, in dem der Inhalt der Webseite angezeigt wird, die beim Klicken auf das AdRotator Steuerelement verknüpft ist. Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit Fokus aktualisiert.

Attribute
BindableAttribute TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Target Eigenschaft veranschaulicht. Es zeigt den Inhalt der Webseite an, die verknüpft ist, wenn auf das AdRotator Steuerelement in einem neuen, nicht geframeten Fenster geklickt wird.

<%@ 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ündigungsinformationen enthält. Weitere Informationen zum Dateiformat finden Sie im AdvertisementFile Element.

<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 -frame anzugeben, mit dem der Inhalt der Webseite angezeigt wird, die beim Klicken auf das AdRotator Steuerelement verknüpft ist.

Hinweis

Die Target Eigenschaft wird als target Attribut gerendert. Das target Attribut für Ankerelemente (a) ist in XHTML 1.1 nicht zulässig. Wenn das gerenderte Markup daher den XHTML-Standards entsprechen muss oder den Barrierefreiheitsstandards entsprechen muss, legen Sie die Target Eigenschaft nicht fest. Weitere Informationen finden Sie unter XHTML Standards in Visual Studio und ASP.NET und Barrierefreiheit in Visual Studio und ASP.NET.

Der Target Wert muss mit einem Buchstaben im Bereich von A bis Z beginnen (Groß-/Kleinschreibung wird nicht beachtet), mit Ausnahme der folgenden speziellen Werte, die mit einem Unterstrich beginnen.

Zielwert Beschreibung
_blank Rendert den Inhalt in einem neuen Fenster ohne Frames.
_parent Rendert den Inhalt im übergeordneten Direktframeet.
_search Rendert den Inhalt im Suchbereich.
_self Rendert den Inhalt im Frame mit Fokus.
_top Rendert den Inhalt im vollständigen Fenster ohne Frames.

Hinweis

Überprüfen Sie ihre Browserdokumentation, um zu ermitteln, ob der _search Wert unterstützt wird. Internet Explorer 5.0 oder höher unterstützt z. B. den _search Zielwert.

Gilt für:

Weitere Informationen