MenuItem.Target Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает целевое окно или фрейм, для отображения содержимого веб-страницы, связанной с пунктом меню.
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 свойство , чтобы указать окно или фрейм, в котором будет отображаться веб-содержимое, связанное с элементом меню, при щелчке этого элемента меню.
<%@ 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>MenuItem Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Target Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<items>
<asp:menuitem navigateurl="Home.aspx"
target="_self"
text="Home">
<asp:menuitem navigateurl="Music.aspx"
target="_self"
text="Music">
<asp:menuitem navigateurl="Classical.aspx"
target="_blank"
text="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
target="_blank"
text="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
target="_blank"
text="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
target="_self"
text="Movies">
<asp:menuitem navigateurl="Action.aspx"
target="_blank"
text="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
target="_blank"
text="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
target="_blank"
text="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</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>MenuItem Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Target Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<items>
<asp:menuitem navigateurl="Home.aspx"
target="_self"
text="Home">
<asp:menuitem navigateurl="Music.aspx"
target="_self"
text="Music">
<asp:menuitem navigateurl="Classical.aspx"
target="_blank"
text="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
target="_blank"
text="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
target="_blank"
text="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
target="_self"
text="Movies">
<asp:menuitem navigateurl="Action.aspx"
target="_blank"
text="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
target="_blank"
text="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
target="_blank"
text="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
Комментарии
Используйте свойство , Target чтобы указать окно или фрейм, в котором будет отображаться веб-содержимое, связанное с элементом меню, при щелчке этого пункта меню. Значения должны начинаться с буквы от "A" до "Z" (регистр учитывается), за исключением некоторых специальных значений, начинающиеся со знака подчеркивания, как показано в следующей таблице. Обратите внимание, что установка этого свойства переопределяет Target свойство Menu элемента управления для этого пункта меню.
Целевое значение | Описание |
---|---|
_blank |
Отображает содержимое в новом окне без фреймов. |
_parent |
Отрисовывает содержимое в непосредственно родительском элементе набора фреймов. |
_search |
Отображает содержимое в панели поиска. |
_self |
Отображает содержимое во фрейме с фокусировкой. |
_top |
Отображает содержимое в окне без фреймов. |
Примечание
Чтобы выяснить, поддерживается ли значение _search
, следует обратиться к документации браузера. Например, Microsoft Internet Explorer 5.0 или более поздней версии поддерживает целевое значение _search
.
Примечание
Свойство Target отображается в виде атрибута target
. Атрибут target
элементов привязки не допускается в определении строгого типа документа XHTML 1.1. Не устанавливайте свойство , Target если отображаемые выходные HyperLink данные для должны быть совместимы с XHTML 1.1. Дополнительные сведения см. в разделах Стандарты XHTML в Visual Studio и ASP.NET.
При создании веб-страниц со специальными возможностями настоятельно рекомендуется избегать использования свойства для другого Target окна. Дополнительные сведения см. в статье Accessibility Support in ASP.NET (Поддержка специальных возможностей в ASP.NET).