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 属性指定要绑定到 Target 对象的 属性 TreeNode 的值。 此绑定关系会影响应用该TreeNodeBinding对象的所有TreeNode对象。 属性 Target 用于指定在单击某个节点时要在其中显示链接到该节点的 Web 内容的窗口或框架。

注意

Target设置 属性将TargetTreeView覆盖对象所应用到的节点的 控件的 属性TreeNodeBinding。 可以通过直接设置Target每个节点的 属性来有选择地替代 Target 属性。

注意

属性 Target 呈现为 target 属性。 target XHTML 1.1 文档类型定义中不允许元素上的 anchor 属性。 如果控件的呈现输出TreeNodeBinding必须符合 XHTML 1.1,请不要设置 Target 属性。 有关详细信息,请参阅 Visual Studio 中的 XHTML 标准和 ASP.NET

创建可访问的网页时,应避免使用 Target 属性以另一个窗口为目标。 有关详细信息,请参阅 ASP.NET 辅助功能

此属性的值存储在视图状态中。

适用于

另请参阅