MenuItemBinding.Target Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví cílové okno nebo rámec, ve kterém chcete zobrazit obsah webové stránky přidružené k položce nabídky, na kterou MenuItemBinding je objekt použit.

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

Hodnota vlastnosti

String

Cílové okno nebo rámec, ve kterém chcete zobrazit obsah propojené webové stránky. Výchozí hodnotou je prázdný řetězec (""), který aktualizuje okno nebo rámec s fokusem.

Příklady

Následující příklad kódu ukazuje, jak použít Target vlastnost k určení okna, ve kterém se má zobrazit webový obsah přidružený k položce nabídky, při kliknutí na tuto položku nabídky. Aby tento příklad fungoval správně, musíte zkopírovat níže uvedená ukázková data XML do souboru s názvem 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>

Následující kód představuje ukázková data mapy webu pro předchozí příklad.

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

Poznámky

Menu Pokud je ovládací prvek svázán se zdrojem dat, pomocí Target vlastnosti určete okno nebo rámec, ve kterém se má zobrazit webový obsah propojený s položkou nabídky při kliknutí na tuto položku nabídky.

Poznámka

Nastavení této vlastnosti přepíše Menu.Target vlastnost Menu ovládacího prvku pro položky nabídky, na které MenuItemBinding je objekt použit. Tuto vlastnost můžete selektivně přepsat nastavením MenuItem.Target vlastnosti každé položky nabídky přímo.

Cílové hodnoty musí začínat písmenem v rozsahu A až Z (nerozlišují se malá a velká písmena), s výjimkou určitých speciálních hodnot, které začínají podtržítkem, jak je znázorněno v následující tabulce.

Cílová hodnota	Description
`_blank`	Vykreslí obsah v novém okně bez rámců.
`_parent`	Vykreslí obsah v bezprostředně nadřazené sadě rámců.
`_search`	Vykreslí obsah v podokně hledání.
`_self`	Vykreslí obsah v rámci s fokusem.
`_top`	Vykreslí obsah v celém okně bez snímků.

Poznámka

Projděte si dokumentaci k prohlížeči _search a zjistěte, jestli je hodnota podporovaná. Například Microsoft Internet Explorer 5.0 a novější podporují _search cílovou hodnotu.

Poznámka

Vlastnost se Target vykreslí jako target atribut. Atribut target elementů anchor není povolen v definici typu dokumentu XHTML 1.1. Nenastavujte Target vlastnost, pokud vykreslený výstup pro MenuItemBinding objekt musí být kompatibilní s XHTML 1.1. Další informace najdete v tématu Standardy XHTML v sadě Visual Studio a ASP.NET.

Při vytváření přístupných webových stránek se důrazně doporučuje vyhnout se použití Target vlastnosti k cílení na jiné okno. Další informace najdete v tématu ASP.NET Usnadnění.

Platí pro

Sdílet prostřednictvím

MenuItemBinding.Target Vlastnost

Definice

Hodnota vlastnosti

Příklady

Poznámky

Platí pro

Viz také

Další materiály