MenuItemBinding.Target Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает целевое окно или фрейм для отображения содержимого веб-страницы, связанной с пунктом меню, к которому применяется объект MenuItemBinding.
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
Значение свойства
Целевое окно или фрейм, для отображения связанного содержимого веб-страницы. Значение по умолчанию — пустая строка (""), обновляющая окно или фрейм, имеющий фокус.
Примеры
В следующем примере кода показано, как использовать Target свойство для указания окна, в котором отображается веб-содержимое, связанное с элементом меню, при щелчке этого элемента меню. Чтобы этот пример работал правильно, необходимо скопировать приведенные ниже примеры XML-данных в файл с именем 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>
Следующий код является примером данных карты сайта для предыдущего примера.
<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>
Комментарии
Menu Если элемент управления привязан к источнику данных, используйте Target свойство, чтобы указать окно или кадр, в котором отображается веб-содержимое, связанное с элементом меню при щелчке этого элемента меню.
Примечание
Задание этого свойства переопределяет Menu.Target свойство Menu элемента управления для элементов меню, к которым MenuItemBinding применяется объект. Вы можете выборочно переопределить это свойство, задав MenuItem.Target свойство каждого пункта меню напрямую.
Целевые значения должны начинаться с буквы в диапазоне от A до Z (без учета регистра), за исключением определенных специальных значений, начинающихся с подчеркивания, как показано в следующей таблице.
Целевое значение | Описание |
---|---|
_blank |
Отображает содержимое в новом окне без фреймов. |
_parent |
Отрисовывает содержимое в непосредственно родительском элементе набора фреймов. |
_search |
Отображает содержимое в панели поиска. |
_self |
Отображает содержимое во фрейме с фокусировкой. |
_top |
Отображает содержимое в окне без фреймов. |
Примечание
Чтобы выяснить, поддерживается ли значение _search
, следует обратиться к документации браузера. Например, Microsoft Internet Explorer 5.0 или более поздней версии поддерживает целевое значение _search
.
Примечание
Свойство Target отображается как target
атрибут. Атрибут target
элементов anchor
не допускается в определении типа документа XHTML 1.1. Не устанавливайте свойство, Target если отображаемые выходные данные для MenuItemBinding объекта должны соответствовать XHTML 1.1. Дополнительные сведения см. в разделе "Стандарты XHTML" в Visual Studio и ASP.NET.
При создании веб-страниц со специальными возможностями настоятельно рекомендуется избегать использования Target свойства для другого окна. Дополнительные сведения см. в разделе ASP.NET специальных возможностей.