TreeNodeBinding.ValueField プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引

TreeNodeBinding.ValueField プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

データソースからフィールドの名前を取得または設定し、TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの Value プロパティにバインドします。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property ValueField As
 String

Visual Basic (使用法)

Dim instance As TreeNodeBinding
Dim value As String

value = instance.ValueField

instance.ValueField = value

public string ValueField { get;
 set; }

C++

public:
property String^ ValueField {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ValueField ()

/** @property */
public void set_ValueField (String value)

JScript

public function get ValueField
 () : String

public function set ValueField
 (value : String)

プロパティ値
TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの Value プロパティにバインドするフィールドの名前。既定値は空の文字列 ("") です。ValueField プロパティが設定されていないことを示します。

解説

TreeView コントロールをデータソースにバインドする場合、TreeNode オブジェクトの Value プロパティにバインドするフィールド名は、ValueField プロパティで指定します。このバインディングの関係は、TreeNodeBinding オブジェクトが適用されるすべての TreeNode オブジェクトに影響します。Value プロパティを使用して、TreeNodeBinding オブジェクトが適用されるノードに関連付けられた補足データを格納することにより、Text プロパティを補足します。この値はコントロールには表示されず、ポストバックイベントを処理するためのデータを格納するために使用されるのが一般的です。

メモ
ValueField プロパティは、各ノードの Value プロパティを直接設定することにより、選択的にオーバーライドできます。

ValueField プロパティを使用して TreeNode オブジェクトの Value プロパティをフィールドにバインドする代わりに、Value プロパティを設定して、Value プロパティを固定値に設定できます。

メモ
データソースに複数のフィールドが含まれている場合は、最初に、Depth プロパティと DataMember プロパティのいずれか、または両方を設定して適切なフィールドにバインドする必要があります。

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

使用例

このセクションには、2 つのコード例が含まれています。ValueField プロパティを使用して、TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの Value プロパティに対して、XML 要素のどの属性をバインドするかを指定する方法を最初のコード例に示します。最初のコード例に対応したサンプル XML データを 2 番目のコード例に示します。

ValueField プロパティを使用して、TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの Value プロパティに対して、XML 要素のどの属性をバインドするかを指定する方法を次の例に示します。この例を正常に動作させるには、このコード例の後に示すサンプル XML データを、Booklist.xml という名前のファイルにコピーする必要があります。

Visual Basic

<%@ Page Language="VB" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField,
 -->
      <!-- ValueField, and ToolTipField properties of
 a    -->
      <!-- TreeNodeBinding object declaratively.         -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books"
 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book"
 
            Depth="1" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <asp:TreeNodeBinding DataMember="Description"
 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price"
 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"
  
        DataFile="Booklist.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField properties of a    -->
      <!-- TreeNodeBinding object declaratively.         -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        Target="_blank" 
        runat="server">
          
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Books" 
            Depth="0" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Book" 
            Depth="1" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <asp:TreeNodeBinding DataMember="Description" 
            Depth="2" 
            TextField="Text"/>
          <asp:TreeNodeBinding DataMember="Price" 
            Depth="2" 
            TextField="Value"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Booklist.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

前のコード例に対応したサンプル XML データを次のコード例に示します。

<Books Text="Books List">
    <Book Text="Book Title One"
        Value="1" 
        Image="Bookimage1.jpg"
        ImageToolTip="Book 1 Photo" 
        Nav="http://www.microsoft.com"
        Tip="Book Title 1">
        <Description Text="Book Description">
        </Description>
        <Price Value="$1.99">
        </Price>
        <Author Text="Author Name"
            Value="LastName" 
            Image="Authorimage1.jpg" 
            Nav="http://www.microsoft.com"
            Tip="Author Name">
        </Author>
    </Book>
    <Book Text="Book Title Two"
        Value="2" 
        Image="Bookimage2.jpg"
        ImageToolTip="Book 2 Photo" 
        Nav="http://www.microsoft.com"
        Tip="Click Me">
        <Description Text="Book Description">
        </Description>
        <Price Value="$2.99">
        </Price>
        <Author Text="Author Name"
            Value="LastName" 
            Image="Authorimage2.jpg" 
            Nav="http://www.microsoft.com"
            Tip="Author Name">
        </Author>
    </Book>
</Books>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TreeNodeBinding クラス
TreeNodeBinding メンバ
System.Web.UI.WebControls 名前空間
TreeView
TreeNode クラス
DataBindings
TreeNodeBinding.DataMember プロパティ
TreeNodeBinding.Depth プロパティ
TreeNode.ImageUrl プロパティ
TreeNodeBinding.ImageUrl プロパティ
TreeNodeBinding.ImageUrlField プロパティ
TreeNodeBinding.ImageToolTip プロパティ
TreeNodeBinding.ImageToolTipField プロパティ
TreeNode.NavigateUrl プロパティ
TreeNodeBinding.NavigateUrl プロパティ
TreeNodeBinding.NavigateUrlField プロパティ
TreeNode.Text プロパティ
TreeNodeBinding.Text プロパティ
TreeNodeBinding.TextField プロパティ
TreeNode.ToolTip プロパティ
TreeNodeBinding.ToolTip プロパティ
TreeNodeBinding.ToolTipField プロパティ
TreeNode.Value プロパティ
TreeNodeBinding.Value プロパティ

>> 「TreeNodeBinding.ValueField プロパティ」を含む用語の索引
TreeNodeBinding.ValueField プロパティのページへのリンク

TreeNodeBinding.ValueField プロパティとは？わかりやすく解説

TreeNodeBinding.ValueField プロパティ

英和和英テキスト翻訳


	© 2026 Microsoft.All rights reserved.

TreeNodeBinding.ValueField プロパティとは？ わかりやすく解説

TreeNodeBinding.ValueField プロパティ

英和和英テキスト翻訳

TreeNodeBinding.ValueField プロパティとは？わかりやすく解説