TreeNodeBinding.Target 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定目標視窗或框架,在其中顯示與套用 TreeNodeBinding 物件之節點相關聯的 Web 網頁內容。
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
屬性值
在其中顯示連結 Web 網頁內容的目標視窗或框架。 除了以底線為開頭的某些特殊值以外,值必須以 A 到 Z (不區分大小寫) 範圍內的字母為開頭,如下表所示。
目標值 | 描述 |
---|---|
_blank | 在無框架的新視窗中呈現內容。 |
_parent | 在即時父代框架組中呈現內容。 |
_search | 在搜尋窗格中呈現內容。 |
_self | 在擁有焦點 (Focus) 的框架中呈現內容。 |
_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 是用來指定視窗或框架,用來顯示單擊該節點時連結到節點的 Web 內容。
注意
Target設定 屬性會Target覆寫套用物件之節點TreeNodeBinding之 控件的 TreeView 屬性。 您可以直接設定Target每個節點的 屬性,以選擇性地覆寫 Target 屬性。
注意
屬性 Target 會轉譯為 target
屬性。
target
XHTML 1.1 檔案類型定義中不允許元素上的 anchor
屬性。 如果控件的轉譯輸出TreeNodeBinding必須符合 XHTML 1.1 規範,請勿設定 Target 屬性。 如需詳細資訊,請參閱 Visual Studio中的 XHTML 標準與 ASP.NET。
建立可存取的網頁時,您應該避免使用 Target 屬性以另一個視窗為目標。 如需詳細資訊,請參閱 ASP.NET 輔助功能。
此屬性的值會儲存在檢視狀態中。