共用方式為


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 的值。 這種綁定關係影響所有 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 無障礙

此屬性的價值會儲存在視圖狀態。

適用於

另請參閱