MenuItemBinding.Target Eigenschaft

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.

Dient zum Abrufen oder Festlegen des Zielfensters oder Frames, in dem der Webseiteninhalt angezeigt werden soll, der einem Menüelement zugeordnet ist, auf das das MenuItemBinding Objekt angewendet wird.

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 das Fenster anzugeben, in dem der Webinhalt angezeigt werden soll, der einem Menüelement zugeordnet ist, wenn auf dieses Menüelement geklickt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispieldaten in eine Datei mit dem Namen Menu.xmlkopieren.


<%@ 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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

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

Der folgende Code ist Beispielwebsitezuordnungsdaten für das vorherige Beispiel.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

Hinweise

Wenn das Menu Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die Target Eigenschaft, um das Fenster oder den Frame anzugeben, in dem der Webinhalt angezeigt werden soll, der mit einem Menüelement verknüpft ist, wenn auf dieses Menüelement geklickt wird.

Hinweis

Durch Festlegen dieser Eigenschaft wird die Menu.Target Eigenschaft des Menu Steuerelements für die Menüelemente außer Kraft gesetzt, auf die das MenuItemBinding Objekt angewendet wird. Sie können diese Eigenschaft selektiv außer Kraft setzen, indem Sie die MenuItem.Target Eigenschaft jedes Menüelements direkt festlegen.

Zielwerte 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. Beispielsweise unterstützen Microsoft Internet Explorer 5.0 und höher den _search Zielwert.

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 das MenuItemBinding Objekt 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 ASP.NET Barrierefreiheit.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?

Freigeben über

MenuItemBinding.Target Eigenschaft

Definition

Eigenschaftswert

Beispiele

Hinweise

Gilt für:

Weitere Informationen

Feedback