TreeView.AutoGenerateDataBindings Properti

Definisi

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

Mendapatkan atau menetapkan nilai yang menunjukkan apakah TreeView kontrol secara otomatis menghasilkan pengikatan simpul pohon.

public:
 property bool AutoGenerateDataBindings { bool get(); void set(bool value); };
public bool AutoGenerateDataBindings { get; set; }
member this.AutoGenerateDataBindings : bool with get, set
Public Property AutoGenerateDataBindings As Boolean

Nilai Properti

Boolean

true TreeView agar kontrol secara otomatis menghasilkan pengikatan simpul pohon; jika tidak, false. Defaultnya adalah true.

Contoh

Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menonaktifkan pembuatan pengikatan simpul pohon otomatis dengan mengatur AutoGenerateDataBindings properti ke false. Contoh kode kedua menyediakan contoh data peta situs untuk contoh kode pertama.

Contoh kode berikut menunjukkan cara menonaktifkan pembuatan pengikatan simpul pohon otomatis dengan mengatur AutoGenerateDataBindings properti ke false. Koleksi DataBindings kemudian didefinisikan untuk membangun hubungan antara item data dalam SiteMapDataSource kontrol dan simpul TreeView kontrol. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data peta situs sampel, yang disediakan setelah contoh kode ini, ke file bernama Web.sitemap.


<%@ 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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </form>
  </body>
</html>

Contoh kode berikut menyediakan contoh data peta situs untuk contoh sebelumnya.

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>
        </siteMapNode>
    </siteMapNode>
</siteMap>

Keterangan

Pengikatan simpul pohon menentukan hubungan antara item data dan node yang diikatnya. Saat mengikat ke sumber data di mana setiap item data berisi beberapa properti (seperti elemen XML dengan beberapa atribut), TreeView kontrol perlu mengetahui properti item data mana yang akan diikat ke properti mana TreeNode . AutoGenerateDataBindings Jika properti diatur ke true, TreeView kontrol secara otomatis menghasilkan pengikatan simpul pohon default yang mengatur Text properti TreeNode objek yang terkait dengan pengikatan ke nilai yang dikembalikan oleh ToString metode item data.

Nota

Pengikatan simpul pohon yang dihasilkan secara otomatis tidak ditambahkan ke DataBindings koleksi.

Dalam kasus elemen XML, nilai yang dikembalikan oleh ToString metode adalah nama elemen, yang menunjukkan struktur yang mendasar dari file XML, tetapi tidak terlalu berguna sebaliknya. Untuk membuat pohon yang lebih berguna, Anda harus menentukan pengikatan simpul pohon Anda sendiri dengan mengisi DataBindings koleksi.

Nota

Jika Anda menentukan DataBindings koleksi, kontrol menggunakan nilai tersebut TreeView alih-alih pengikatan simpul pohon yang dihasilkan secara otomatis.

Nilai properti ini disimpan dalam status tampilan.

Berlaku untuk

Lihat juga