Bagikan melalui

TreeView.MaxDataBindDepth Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur jumlah maksimum tingkat pohon untuk mengikat TreeView kontrol.

public:
 property int MaxDataBindDepth { int get(); void set(int value); };
public int MaxDataBindDepth { get; set; }
member this.MaxDataBindDepth : int with get, set
Public Property MaxDataBindDepth As Integer

Nilai Properti

Int32

Jumlah maksimum tingkat pohon yang akan diikat ke TreeView kontrol. Defaultnya adalah -1, yang mengikat semua tingkat pohon dalam sumber data ke kontrol.

Pengecualian

ArgumentOutOfRangeException

Nilai yang dipilih kurang dari -1.

Contoh

Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan MaxDataBindDepth properti untuk hanya mengikat dua tingkat node pertama (kedalaman 0 dan 1) ke TreeView kontrol. Contoh kode kedua menyediakan contoh data XML untuk contoh kode pertama.

Contoh kode berikut menunjukkan cara menggunakan MaxDataBindDepth properti untuk hanya mengikat dua tingkat node pertama (kedalaman 0 dan 1) ke TreeView kontrol. Semua tingkat node di sumber data diabaikan. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data XML sampel, yang disediakan setelah contoh kode ini, ke file bernama 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>TreeView MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" 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="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>TreeView MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" 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>

Contoh kode berikut menyediakan contoh data XML untuk contoh kode sebelumnya.

<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>

Keterangan

Saat mengikat kontrol ke TreeView sumber data, gunakan MaxDataBindDepth properti untuk membatasi jumlah tingkat pohon untuk mengikat kontrol. Misalnya, mengatur properti ini untuk 2 hanya mengikat simpul akar dan simpul apa pun yang segera berada di bawah simpul akar ke TreeView kontrol. Semua simpul yang tersisa di sumber data diabaikan.

Penting

Pengguna berbahaya dapat membuat permintaan panggilan balik dan mendapatkan data untuk simpul TreeView kontrol yang tidak ditampilkan pengembang halaman. Oleh karena itu, keamanan data harus diimplementasikan oleh sumber data. Jangan gunakan MaxDataBindDepth properti untuk menyembunyikan data.

Nilai properti ini disimpan dalam status tampilan.

Berlaku untuk

Lihat juga