HyperLink.Target Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

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

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set

Public Property Target As String

Eigenschaftswert

String

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`	Gibt den Inhalt im Suchbereich wieder.
`_self`	Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.
`_top`	Stellt den Inhalt im gesamten Fenster ohne Frames dar.

Hinweis: Überprüfen Sie ihre Browserdokumentation, um festzustellen, 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 ("").

Attribute: BindableAttribute TypeConverterAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Target -Eigenschaft festgelegt wird, um das Fenster oder den Frame anzugeben, um die dem HyperLink Steuerelement zugeordnete Seite anzuzeigen.

<%@ 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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

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

</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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

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

</form>
</body>
</html>

Hinweise

Verwenden Sie die Target -Eigenschaft, um den Rahmen oder das Fenster anzugeben, in dem die Webseite angezeigt wird, mit der bzw. das beim Klicken auf das HyperLink Steuerelement verknüpft ist. Die Webseite wird durch Festlegen der NavigateUrl -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 XHTML 1.1-Dokumenttypdefinition nicht zulässig. Legen Sie die Target -Eigenschaft nicht fest, wenn die gerenderte Ausgabe für XHTML HyperLink 1.1-kompatibel sein muss. Weitere Informationen finden Sie im Thema XHTML-Standards in Visual Studio und ASP.NET.

Beim Erstellen barrierefreier Webseiten wird dringend empfohlen, die Verwendung der Target -Eigenschaft für ein anderes Fenster zu vermeiden. Weitere Informationen finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET-Steuerelemente und Barrierefreiheit.

Gilt für:

Freigeben über