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 的值。 這種綁定關係影響所有 TreeNode 該物件所 TreeNodeBinding 應用的物件。 此 Target 屬性用來指定在點擊節點時,顯示連結到節點的網頁內容的視窗或框架。
備註
設定該Target屬性會Target覆蓋該物件所應用節點TreeNodeBinding控制項的TreeView屬性。 你可以選擇性地覆蓋這個 Target 屬性,直接設定 Target 每個節點的屬性。
備註
該 Target 屬性以屬性形式呈現 target 。 XHTML 1.1 文件類型定義中不允許元素屬性targetanchor。 如果控制項的渲染輸出TreeNodeBinding必須符合 XHTML 1.1 標準,請不要設定該Target屬性。 欲了解更多資訊,請參閱 Visual Studio 及 ASP.NET 中的 XHTML 標準。
在建立無障礙網頁時,應避免使用該 Target 屬性來指向其他視窗。 更多資訊請參閱 ASP.NET 無障礙。
此屬性的價值會儲存在視圖狀態。