TreeView.DataBindings プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文データ項目とそのバインド先のノードとの間の関係を表す TreeNodeBindingCollection。
解説DataBindings コレクションには、データ項目とそのバインド先のノードとの間の関係を定義する TreeNodeBinding オブジェクトが含まれています。複数の属性を持つ XML 要素などのように、各データ項目に複数のプロパティが含まれているデータ ソースにバインドする場合、ノードにはデータ項目の ToString メソッドから返される値が既定で表示されます。XML 要素の場合、ノードには要素名が表示されます。これはメニュー ツリーの基になる構造体を示す以外はあまり用途はありません。ツリー ノードのバインディングを指定することにより、ノードを特定のデータ項目のプロパティにバインドできます。
データ項目とノードの間の関係を定義する場合、バインディング基準と TreeNode オブジェクトのプロパティにバインドされる値の両方を指定する必要があります。基準は、データ項目をノードにバインドするタイミングを示します。基準は、ノードの深さ、データ メンバ、またはその両方で指定できます。ノードの深さはバインドされるノード レベルを指定します。たとえば、ノードの深さに 0 を指定すると、ツリー構造のレベル 0 にあるすべてのノードが、ツリー ノードのバインディングを使用してバインドされます。データ メンバは、基になるデータ ソースのデータ項目の型を指定します。ただし、データ ソースによっては異なる情報を表している場合があります。たとえば、XML 要素のデータ メンバは、要素名を指定します。
互いに競合する複数の TreeNodeBinding オブジェクトが定義されている場合、TreeView コントロールは次の優先順位でツリー ノードのバインディングを適用します。
同じ優先順位の基準を満たす複数のバインディングが指定されている場合は、コレクション内の最初のバインディングが適用されます。
バインディング基準を確立したら、バインド可能な TreeNode オブジェクトのプロパティを値にバインドできます。データ項目の属性またはフィールドにバインドするか、または静的な値を表示できます。TreeNode オブジェクトのプロパティを値にバインドする方法の詳細については、TreeNodeBinding のトピックを参照してください。
DataBindings コレクションはプログラムにより設定できますが、通常は宣言によって設定されます。ツリー ノードのバインディングを指定するには、まず TreeView コントロールの開始タグと終了タグの間に <DataBindings> の開始タグと終了タグを入れ子にします。次に、指定するツリー ノードのバインディングごとに、<DataBindings> の開始タグと終了タグの間に <asp:TreeNodeBinding> 要素を入れます。
TreeView コントロールの AutoGenerateDataBindings プロパティを true に設定してデータ バインディングを作成した場合、作成されるバインディングの PopulateOnDemand プロパティは true に設定されます。宣言によって作成されるデータ バインディングの PopulateOnDemand プロパティは、false に設定されます。宣言構文を使用すると、個々のデータ バインディングの動作を制御できます。
使用例このセクションには、2 つのコード例が含まれています。DataBindings コレクションを使用して、データ項目とそのバインド先のノードとの間の関係を定義する方法を最初のコード例に示します。最初のコード例に対応したサンプル XML データを 2 番目のコード例に示します。
DataBindings コレクションを使用して、データ項目とそのバインド先のノードとの間の関係を定義する方法を次のコード例に示します。この例を正常に動作させるには、このコード例の後に示すサンプル XML データを、Book.xml という名前のファイルにコピーする必要があります。この例では、バインディングの DataMember プロパティだけを指定します。Depth プロパティも指定すると、効率が少し向上する可能性があります。
<%@ Page Language="VB" %> <html> <body> <form runat="server"> <h3>TreeView XML Data Binding Example</h3> <asp:TreeView id="BookTreeView" DataSourceID=BookXmlDataSource runat="server"> <DataBindings> <asp:TreeNodeBinding DataMember="Book" TextField="Title"/> <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/> <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/> </DataBindings> </asp:TreeView> <asp:XmlDataSource id="BookXmlDataSource" DataFile="Book.xml" runat="server"> </asp:XmlDataSource> </form> </body> </html>
<%@ Page Language="C#" %> <html> <body> <form runat="server"> <h3>TreeView XML Data Binding Example</h3> <asp:TreeView id="BookTreeView" DataSourceID=BookXmlDataSource runat="server"> <DataBindings> <asp:TreeNodeBinding DataMember="Book" TextField="Title"/> <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/> <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/> </DataBindings> </asp:TreeView> <asp:XmlDataSource id="BookXmlDataSource" DataFile="Book.xml" runat="server"> </asp:XmlDataSource> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からTreeView.DataBindings プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からTreeView.DataBindings プロパティ
を検索
- TreeView.DataBindings プロパティのページへのリンク
