MenuItemBinding.Target Vlastnost
Definice
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 se má 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, setPublic Property Target As StringHodnota vlastnosti
Cílové okno nebo rámeček, ve kterém se má zobrazit propojený obsah webové stránky. Výchozí hodnota je prázdný řetězec (""), který aktualizuje okno nebo rámeček s fokusem.
Příklady
Následující příklad kódu ukazuje, jak použít Target vlastnost určit okno, 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 ukázková data XML níže 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 vázán na zdroj dat, použijte Target vlastnost určit okno nebo rámec, ve kterém chcete 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 oblasti A až Z (nerozlišují 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 nadřazené sadě snímků. |
_search |
Vykreslí obsah v podokně hledání. |
_self |
Vykreslí obsah v rámci s fokusem. |
_top |
Vykreslí obsah v úplném okně bez rámců. |
Poznámka:
Zkontrolujte dokumentaci k prohlížeči a zjistěte, jestli je hodnota podporovaná _search . Například Aplikace Microsoft Internet Explorer 5.0 a novější podporuje _search cílovou hodnotu.
Poznámka:
Vlastnost Target se vykreslí jako target atribut. Atribut target elementů anchor není povolen v definici typu dokumentu XHTML 1.1. Nenastavujte Target vlastnost, pokud vykreslený výstup objektu MenuItemBinding musí být kompatibilní s XHTML 1.1. Další informace najdete v tématu XHTML Standardy v sadě Visual Studio a ASP.NET.
Při vytváření přístupných webových stránek důrazně doporučujeme vyhnout se použití Target vlastnosti pro cílení na jiné okno. Další informace najdete v tématu ASP.NET Přístupnost.
