TreeNodeBinding.Target Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Получает или задает целевое окно или фрейм для отображения содержимого веб-страницы, связанного с узлом, к которому применяется объект 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

Значение свойства

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 свойство , чтобы указать значение для привязки к свойству TargetTreeNode объекта . Эта связь привязки влияет на все 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 специальные возможности.

Значение этого свойства хранится в состоянии представления.

Применяется к

См. также раздел