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

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

索引トップ用語の索引ランキング

TreeView.MaxDataBindDepth プロパティ

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

TreeView コントロールにバインドされるツリーレベルの最大数を取得または設定します。

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

Visual Basic (宣言)

Public Property MaxDataBindDepth As
 Integer

Visual Basic (使用法)

Dim instance As TreeView
Dim value As Integer

value = instance.MaxDataBindDepth

instance.MaxDataBindDepth = value

public int MaxDataBindDepth { get;
 set; }

C++

public:
property int MaxDataBindDepth {
    int get ();
    void set (int value);
}

/** @property */
public int get_MaxDataBindDepth ()

/** @property */
public void set_MaxDataBindDepth (int
 value)

JScript

public function get MaxDataBindDepth
 () : int

public function set MaxDataBindDepth
 (value : int)

プロパティ値
TreeView コントロールにバインドされるツリーレベルの最大数。既定値は -1 で、データソース内のすべてのツリーレベルをコントロールにバインドします。

解説

TreeView コントロールをデータソースにバインドする場合、MaxDataBindDepth プロパティを使用して、コントロールにバインドされるツリーレベルの数を制限します。たとえば、このプロパティを 2 に設定すると、ルートノードとルートノードのすぐ下のノードだけが TreeView コントロールにバインドされます。データソース内の残りのノードはすべて無視されます。

セキュリティに関するメモ
悪意のあるユーザーは、コールバック要求を作成して、ページ開発者が表示していない TreeView コントロールのノードのデータを取得できます。したがって、データのセキュリティをデータソースにより実装する必要があります。MaxDataBindDepth プロパティを使用してデータを非表示にしないでください。

セキュリティに関するメモ

悪意のあるユーザーは、コールバック要求を作成して、ページ開発者が表示していない TreeView コントロールのノードのデータを取得できます。したがって、データのセキュリティをデータソースにより実装する必要があります。MaxDataBindDepth プロパティを使用してデータを非表示にしないでください。

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

使用例

このセクションには、2 つのコード例が含まれています。MaxDataBindDepth プロパティを使用して、最初の 2 つのノードレベル (深さ 0 と 1) だけを TreeView コントロールにバインドする方法を最初のコード例に示します。最初のコード例に対応したサンプル XML データを 2 番目のコード例に示します。

MaxDataBindDepth プロパティを使用して、最初の 2 つのノードレベル (深さ 0 と 1) だけを TreeView コントロールにバインドする方法を次のコード例に示します。データソース内の他のノードレベルはすべて無視されます。この例を正常に動作させるには、このコード例の後に示すサンプル XML データを、Book.xml という名前のファイルにコピーする必要があります。

Visual Basic

<%@ Page Language="VB" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        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 MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        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>

前のコード例に対応したサンプル 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>
</Book>

プラットフォーム

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

参照

関連項目
TreeView クラス
TreeView メンバ
System.Web.UI.WebControls 名前空間
TreeView.ExpandDepth プロパティ

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


	© 2024 Microsoft.All rights reserved.

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

TreeView.MaxDataBindDepth プロパティ

急上昇のことば

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