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

注意

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

注意

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

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

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

適用対象

次の方法で共有

TreeNodeBinding.Target プロパティ

定義

プロパティ値

例

注釈

適用対象

こちらもご覧ください

その他のリソース