Freigeben über

Menu.Target Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen des Zielfensters oder Frames, in dem der Webseiteninhalt angezeigt werden soll, der einem Menüelement zugeordnet ist.

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

String

Das Zielfenster oder -frame, in dem der verknüpfte Webseiteninhalt angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die das Fenster oder den Frame mit Fokus aktualisiert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Target Eigenschaft verwendet wird, um anzugeben, dass der mit den einzelnen Menüelementen verknüpfte Inhalt 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 im Bereich von A bis Z (Groß-/Kleinschreibung) beginnen, mit Ausnahme bestimmter spezieller Werte, die mit einem Unterstrich beginnen, wie in der folgenden Tabelle dargestellt.

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-Versionen 5.0 und höher unterstützen z. B. 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 Zielatribut für Ankerelemente ist in der strengen XHTML 1.1-Dokumenttypdefinition 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.

Gilt für:

Weitere Informationen