TreeNodeBinding.Target Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает целевое окно или кадр, в котором отображается содержимое веб-страницы, связанное с узлом, к которому TreeNodeBinding применяется объект.
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
Значение свойства
Целевое окно или кадр, в котором отображается содержимое связанной веб-страницы. Значения должны начинаться с буквы в диапазоне от A до Z (без учета регистра), за исключением определенных специальных значений, начинающихся с подчеркивания, как показано в следующей таблице.
| Целевое значение | Описание |
|---|---|
_blank | Отрисовывает содержимое в новом окне без кадров. |
_parent | Отрисовывает содержимое в родительском элементе немедленного набора кадров. |
_search | Отрисовывает содержимое в области поиска. |
_self | Отрисовывает содержимое в кадре с фокусом. |
_top | Отрисовывает содержимое в полном окне без кадров. |
Примечание. Проверьте документацию по браузеру _search , чтобы определить, поддерживается ли значение. Например, Microsoft Internet Explorer версии 5.0 и более поздних версий поддерживает целевое _search значение.
По умолчанию используется пустая строка (""), которая обновляет окно или кадр с фокусом.
Примеры
В этом разделе содержатся два примера кода. В первом примере кода показано, как использовать Target свойство, чтобы указать, что веб-страница, связанная с корневым узлом, должна отображаться в новом окне. Второй пример кода содержит примеры XML-данных для первого примера кода.
В следующем примере показано, как использовать Target свойство, чтобы указать, что веб-страница, связанная с корневым узлом, должна отображаться в новом окне. Для правильной работы этого примера необходимо скопировать примеры XML-данных, предоставленных после этого примера кода, в файл с именем Book.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>TreeNodeBinding Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBinding Target Example</h3>
<!-- Clicking the root node will navigate -->
<!-- the user to another page. Because the -->
<!-- Target property is set to "_blank", -->
<!-- the linked page is displayed in a new -->
<!-- window. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book"
Depth="0"
TextField="Title"
NavigateUrl="~\Page1.aspx"
Target="_blank"/>
<asp:TreeNodeBinding DataMember="Chapter"
Depth="1"
TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix"
Depth="1"
TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</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>TreeNodeBinding Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBinding Target Example</h3>
<!-- Clicking the root node will navigate -->
<!-- the user to another page. Because the -->
<!-- Target property is set to "_blank", -->
<!-- the linked page is displayed in a new -->
<!-- window. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book"
Depth="0"
TextField="Title"
NavigateUrl="~\Page1.aspx"
Target="_blank"/>
<asp:TreeNodeBinding DataMember="Chapter"
Depth="1"
TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix"
Depth="1"
TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
В следующем примере кода приведены примеры XML-данных для предыдущего примера кода.
<Book Title="Book Title">
<Chapter Heading="Chapter 1">
<Section Heading="Section 1">
</Section>
<Section Heading="Section 2">
</Section>
</Chapter>
<Chapter Heading="Chapter 2">
<Section Heading="Section 1">
</Section>
</Chapter>
<Appendix Heading="Appendix A">
</Appendix>
</Book>
Комментарии
TreeView Если элемент управления привязан к источнику данных, используйте Target свойство, чтобы указать значение для привязки TreeNode к Target свойству объекта. Эта связь привязки влияет на все TreeNode объекты, к которым TreeNodeBinding применяется объект. Свойство Target используется для указания окна или кадра, в котором отображается веб-содержимое, связанное с узлом при щелчке этого узла.
Замечание
Target Установка свойства переопределяет Target свойство TreeView элемента управления для узлов, к которым TreeNodeBinding применяется объект. Вы можете выборочно переопределить Target свойство, задав Target свойство каждого узла напрямую.
Замечание
Свойство Target отображается как target атрибут. Атрибут target элементов anchor не допускается в определении типа документа XHTML 1.1. Не устанавливайте Target свойство, если отображаемые выходные данные элемента TreeNodeBinding управления должны соответствовать XHTML 1.1. Дополнительные сведения см. в разделе "Стандарты XHTML" в Visual Studio и ASP.NET.
При создании доступных веб-страниц следует избегать использования Target свойства для назначения другого окна. Дополнительные сведения см. в разделе ASP.NET специальные возможности.
Значение этого свойства хранится в состоянии представления.