TreeNodeBinding.Target プロパティ

定義

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 Version 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使用して、オブジェクトのプロパティにバインドする値をTargetTreeNode指定します。 このバインド関係は、オブジェクトが適用されるすべての TreeNode オブジェクトに TreeNodeBinding 影響します。 この Target プロパティは、ノードがクリックされたときにノードにリンクされている Web コンテンツを表示するウィンドウまたはフレームを指定するために使用されます。

注意

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

注意

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

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

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

適用対象

こちらもご覧ください