TreeNodeBinding.Target 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置在其中显示与 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 辅助功能。
此属性的值存储在视图状态中。