TreeNodeBinding.Target プロパティ

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

プロパティ値

String

リンクされた Web ページコンテンツを表示するターゲットウィンドウまたはフレーム。次の表に示すように、アンダースコアで始まる特定の特殊な値を除き、値は A から Z の範囲の文字で始まる必要があります (大文字と小文字は区別されません)。

ターゲット値	説明
`_blank`	フレームなしで新しいウィンドウにコンテンツをレンダリングします。
`_parent`	即時フレームセット親のコンテンツをレンダリングします。
`_search`	検索ウィンドウにコンテンツをレンダリングします。
`_self`	フレーム内のコンテンツをフォーカス付きでレンダリングします。
`_top`	フレームを含まないフルウィンドウでコンテンツをレンダリングします。

注: _search 値がサポートされているかどうかを判断するには、ブラウザーのドキュメントを確認してください。たとえば、Microsoft Internet Explorer バージョン 5.0 以降では、 _search ターゲット値がサポートされています。

既定値は空の文字列 ("") で、ウィンドウまたはフレームをフォーカスで更新します。

例

このセクションには、2 つのコード例が含まれています。最初のコード例では、 Target プロパティを使用して、ルートノードに関連付けられている Web ページを新しいウィンドウに表示するように指定する方法を示します。 2 番目のコード例では、最初のコード例のサンプル XML データを提供します。

次の例では、 Target プロパティを使用して、ルートノードに関連付けられている Web ページを新しいウィンドウに表示するように指定する方法を示します。この例を正しく機能させるには、このコード例の後に提供されるサンプル 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 コンテンツを表示するウィンドウまたはフレームを指定するために使用されます。

Note

Target プロパティを設定すると、Target オブジェクトが適用されるノードのTreeView コントロールのTreeNodeBinding プロパティがオーバーライドされます。各ノードのTarget プロパティを直接設定することで、Target プロパティを選択的にオーバーライドできます。

Note

Target プロパティは、target属性としてレンダリングされます。 XHTML 1.1 ドキュメント型定義では、target要素のanchor属性は使用できません。 Target コントロールのレンダリングされた出力が XHTML 1.1 に準拠している必要がある場合は、TreeNodeBinding プロパティを設定しないでください。詳細については、「 Visual Studio および ASP.NET の XHTML 標準」を参照してください。

アクセス可能な Web ページを作成するときは、 Target プロパティを使用して別のウィンドウを対象としないようにする必要があります。詳細については、「アクセシビリティの ASP.NET」を参照してください。

このプロパティの値はビューステートに格納されます。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?