HyperLink.Target Eigenschaft
Definition
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 Zielrahmen ab, in dem der Webseiteninhalt angezeigt werden soll, der beim Klicken auf das HyperLink Steuerelement verknüpft ist, oder legt diesen 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, setPublic Property Target As StringEigenschaftswert
Das Zielfenster oder -frame zum Laden der Webseite, die verknüpft ist, wenn auf das HyperLink Steuerelement geklickt wird. Werte müssen mit einem Buchstaben im Bereich einer bis z (Groß-/Kleinschreibung) beginnen, mit Ausnahme der in der folgenden Tabelle aufgeführten Sonderwerte, die mit einem Unterstrich beginnen.
_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. Beispielsweise unterstützen Microsoft Internet Explorer 5.0 und höher den _search Zielwert.
Der Standardwert ist eine leere Zeichenfolge ("").
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie die Target Eigenschaft so festgelegt wird, dass das Fenster oder rahmen angegeben wird, 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, mit dem die Webseite angezeigt wird, die 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 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 die HyperLink XHTML 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.
