MenuItemBinding.Target Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger målfönstret eller ramen där webbsidans innehåll som är associerat med ett menyalternativ som MenuItemBinding objektet ska tillämpas på ska visas.

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

Egenskapsvärde

String

Målfönstret eller ramen där det länkade webbplatsinnehållet ska visas. Standardvärdet är en tom sträng (""), som uppdaterar fönstret eller ramen med fokus.

Exempel

Följande kodexempel visar hur du använder Target egenskapen för att ange i vilket fönster webbinnehållet som är associerat med ett menyalternativ ska visas när menyalternativet klickas. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata nedan till en fil med namnet Menu.xml.


<%@ 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>

Följande kod är exempel på webbplatsöversiktsdata för föregående exempel.

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

Kommentarer

Menu När kontrollen är bunden till en datakälla använder du Target egenskapen för att ange det fönster eller den ram där webbinnehållet som är länkat till ett menyalternativ ska visas när menyalternativet klickas.

Note

Om du anger den Menu.Target här egenskapen åsidosätts egenskapen Menu för kontrollen för menyobjekten MenuItemBinding som objektet tillämpas på. Du kan selektivt åsidosätta den här egenskapen genom att ange egenskapen för MenuItem.Target varje menyalternativ direkt.

Målvärden måste börja med en bokstav i intervallet A till Z (skiftlägesokänsligt), förutom vissa specialvärden som börjar med ett understreck, som visas i följande tabell.

Målvärde Description
_blank Renderar innehållet i ett nytt fönster utan bildrutor.
_parent Renderar innehållet i den överordnade ramuppsättningen.
_search Renderar innehållet i sökfönstret.
_self Renderar innehållet i ramen med fokus.
_top Renderar innehållet i det fullständiga fönstret utan bildrutor.

Note

Kontrollera webbläsarens dokumentation för att avgöra om _search värdet stöds. Till exempel stöder Microsoft Internet Explorer 5.0 och senare målvärdet _search.

Note

Egenskapen Target återges som ett target attribut. Attributet target för anchor element tillåts inte i XHTML 1.1-dokumenttypens definition. Ange Target inte egenskapen om de renderade utdata för MenuItemBinding objektet måste vara XHTML 1.1-kompatibla. Mer information finns i avsnittet XHTML-standarder i Visual Studio och ASP.NET.

När du skapar tillgängliga webbsidor rekommenderar vi starkt att du undviker att använda Target egenskapen för att rikta in dig på ett annat fönster. Mer information finns i ASP.NET Accessibility.

Gäller för

Se även