HyperLink.Target-Eigenschaft

Artikel
08/20/2007

Ruft das Zielfenster oder den Zielframe ab, in dem der Inhalt der verknüpften Webseite dargestellt werden soll, wenn auf das HyperLink-Steuerelement geklickt wird, oder legt diese fest.

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

Syntax

'Declaration
Public Property Target As String
'Usage
Dim instance As HyperLink
Dim value As String

value = instance.Target

instance.Target = value

public string Target { get; set; }

public:
property String^ Target {
    String^ get ();
    void set (String^ value);
}

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

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

public function get Target () : String

public function set Target (value : String)

Eigenschaftenwert

Das Zielfenster oder der Zielframe, in dem die verknüpfte Webseite dargestellt werden soll, wenn auf das HyperLink-Steuerelement geklickt wird. Werte müssen mit einem Buchstaben aus dem Bereich von A bis Z (ohne Berücksichtigung der Groß- und Kleinschreibung) beginnen, mit Ausnahme der in der folgenden Liste aufgeführten Werte, die mit einem Unterstrich beginnen:

_blank	Stellt den Inhalt in einem neuen Fenster ohne Frames dar.
_parent	Stellt den Inhalt im unmittelbar übergeordneten Frameset dar.
_search	Stellt den Inhalt im Suchbereich dar.
_self	Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.
_top	Stellt den Inhalt im gesamten Fenster ohne Frames dar.

Hinweis

Sie können der Browserdokumentation entnehmen, ob der _search-Wert unterstützt wird. Beispielsweise unterstützen Microsoft Internet Explorer 5.0 und höhere Versionen den _search-Zielwert.

Der Standardwert ist eine leere Zeichenfolge ("").

Hinweise

Geben Sie mit der Target-Eigenschaft den Frame bzw. das Fenster an, in dem die Webseite angezeigt wird, die beim Klicken auf das HyperLink-Steuerelement geöffnet wird. Die Webseite wird durch Festlegen der href-Eigenschaft angegeben.

Wenn diese Eigenschaft nicht festgelegt ist, wird der Browser oder das Fenster mit dem Fokus aktualisiert, wenn auf das HyperLink-Steuerelement geklickt wird.

Hinweis

Die Target-Eigenschaft wird als target-Attribut gerendert. Das target-Attribut für anchor-Elemente ist in der Dokumentdefinition des Typs XHTML 1.1 nicht zulässig. Legen Sie die Target-Eigenschaft nicht fest, wenn die gerenderte HyperLink-Ausgabe mit XHTML 1.1 kompatibel sein muss. Weitere Informationen finden Sie unter dem Thema ASP.NET und XHTML.

Wenn Sie Webseiten mit Zugriffsmöglichkeit erstellen, wird dringend davon abgeraten, für das Verweisen auf ein anderes Zielfenster die Target-Eigenschaft zu verwenden. Weitere Informationen finden Sie unter ASP.NET-Eingabehilfen.

Beispiel

Das folgende Beispiel veranschaulicht das Festlegen der Target-Eigenschaft, um das Fenster oder den Frame anzugeben, in dem die Seite, die dem HyperLink-Steuerelement zugeordnet ist, angezeigt werden soll.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>

</head>
<body>

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br>  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

</head>
<body>

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br>  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>

</head>
<body>

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br>  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</body>
</html>

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

HyperLink-Klasse
HyperLink-Member
System.Web.UI.WebControls-Namespace
HyperLink.href-Eigenschaft

Weitere Ressourcen

HyperLink-Webserver-Steuerelement

Freigeben über