Menu.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 Zielframe ab, in dem die einem Menüeelement zugeordneten Webseiteninhalte angezeigt werden sollen, oder legt dieses Zielfenster bzw. den Zielframe fest.
public:
property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String
Eigenschaftswert
Das Zielfenster oder der Zielframe, in dem der verknüpfte Webseiteninhalt angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit dem Fokus aktualisiert.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der Target Eigenschaft angegeben wird, dass der inhalt, der mit jedem Menüelement verknüpft ist, in einem neuen Fenster angezeigt werden soll, wenn der Benutzer auf dieses Menüelement klickt.
<%@ Page Language="C#" %>
<!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>Menu Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Target Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Home"
tooltip="Home">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Movies"
tooltip="Movies">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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>Menu Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Target Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Home"
tooltip="Home">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Movies"
tooltip="Movies">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
Hinweise
Verwenden Sie die Target Eigenschaft, um das Fenster oder den Rahmen anzugeben, in dem der Webinhalt angezeigt werden soll, der mit einem Menüelement verknüpft ist, wenn auf dieses Menüelement 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 folgender Tabelle aufgeführten speziellen Werte, die mit einem Unterstrich beginnen:
Zielwert | BESCHREIBUNG |
---|---|
_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
Sie können der Browserdokumentation entnehmen, ob der _search
-Wert unterstützt wird. Beispielsweise unterstützen Internet Explorer-Versionen 5.0 und höher den _search
Zielwert.
Diese Eigenschaft gilt für alle Menüelemente in einem Menu Steuerelement. Sie können diese Eigenschaft selektiv außer Kraft setzen, indem Sie die Target Eigenschaft jedes MenuItem Objekts direkt festlegen.
Hinweis
Die Target Eigenschaft wird als Zielattribute gerendert. Das Zielattribute für Ankerelemente ist in der XHTML 1.1-Definition des strengen Dokumenttyps nicht zulässig. Wenn die gerenderte Ausgabe den XHTML- oder 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.