TreeView.DataBindings Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan kumpulan TreeNodeBinding objek yang menentukan hubungan antara item data dan simpul yang mengikatnya.
public:
property System::Web::UI::WebControls::TreeNodeBindingCollection ^ DataBindings { System::Web::UI::WebControls::TreeNodeBindingCollection ^ get(); };[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TreeNodeBindingCollection DataBindings { get; }[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DataBindings : System.Web.UI.WebControls.TreeNodeBindingCollectionPublic ReadOnly Property DataBindings As TreeNodeBindingCollectionNilai Properti
TreeNodeBindingCollection yang mewakili hubungan antara item data dan simpul yang diikatnya.
- Atribut
Contoh
Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan DataBindings koleksi untuk menentukan hubungan antara item data dan node yang mengikatnya. Contoh kode kedua menyediakan contoh data XML untuk contoh kode pertama.
Contoh kode berikut menunjukkan cara menggunakan DataBindings koleksi untuk menentukan hubungan antara item data dan simpul yang mengikatnya. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data XML sampel, yang disediakan setelah contoh kode ini, ke file bernama Book.xml. Contoh ini hanya DataMember menentukan properti pengikatan. Sedikit perolehan performa dapat ditambahkan dengan juga menentukan Depth properti .
<%@ 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 XML Data Binding Example</title>
</head>
<body>
<form id="form1" 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="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 XML Data Binding Example</title>
</head>
<body>
<form id="form1" 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>
Contoh kode berikut menyediakan contoh data XML untuk contoh 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
Koleksi DataBindings berisi TreeNodeBinding objek yang menentukan hubungan antara item data dan simpul yang diikatnya. Saat mengikat ke sumber data di mana setiap item data berisi beberapa properti (seperti elemen XML dengan beberapa atribut), simpul menampilkan nilai yang dikembalikan oleh ToString metode item data, secara default. Dalam kasus elemen XML, simpul menampilkan nama elemen, yang menunjukkan struktur pohon yang mendasar, tetapi tidak terlalu berguna sebaliknya. Anda dapat mengikat simpul ke properti item data tertentu dengan menentukan pengikatan simpul pohon.
Saat menentukan hubungan antara item data dan simpul, Anda harus menentukan kriteria untuk pengikatan dan nilai untuk mengikat properti TreeNode objek. Kriteria menunjukkan kapan item data harus terikat ke simpul. Kriteria dapat ditentukan dengan kedalaman simpul, anggota data, atau keduanya. Kedalaman node menentukan tingkat simpul yang terikat. Misalnya, jika Anda menentukan kedalaman simpul 0, semua simpul dalam struktur pohon pada tingkat 0 terikat menggunakan pengikatan simpul pohon. Anggota data menentukan jenis item data di sumber data yang mendasar, tetapi dapat mewakili informasi yang berbeda tergantung pada sumber data. Misalnya, anggota data untuk elemen XML menentukan nama elemen .
Jika beberapa TreeNodeBinding objek didefinisikan yang bertentangan satu sama lain, TreeView kontrol menerapkan pengikatan simpul pohon dalam urutan prioritas berikut:
Objek TreeNodeBinding yang menentukan kedalaman dan anggota data.
Objek TreeNodeBinding yang hanya mendefinisikan kedalaman.
Objek TreeNodeBinding yang hanya menentukan anggota data.
Objek TreeNodeBinding yang mendefinisikan kedalaman atau anggota data.
Jika beberapa pengikatan ditentukan yang memenuhi kriteria prioritas yang sama, pengikatan pertama dalam koleksi diterapkan.
Setelah kriteria pengikatan ditetapkan, Anda kemudian dapat mengikat properti TreeNode objek yang dapat terikat ke nilai. Anda dapat mengikat atribut atau bidang item data atau menampilkan nilai statis. Untuk informasi selengkapnya tentang mengikat properti TreeNode objek ke nilai, lihat TreeNodeBinding.
DataBindings Meskipun koleksi dapat diisi secara terprogram, biasanya diatur secara deklaratif. Untuk menentukan pengikatan simpul pohon, tag pembukaan dan penutupan <DataBindings> sarang pertama antara tag TreeView pembuka dan penutup kontrol. Selanjutnya, tempatkan <asp:TreeNodeBinding> elemen antara tag pembuka dan penutup <DataBindings> untuk setiap pengikatan simpul pohon yang ingin Anda tentukan.
Ketika pengikatan data dibuat dengan mengatur AutoGenerateDataBindings properti kontrol ke true, pengikatan yang dibuat memiliki properti yang PopulateOnDemand diatur ke trueTreeView . Pengikatan data yang dibuat secara deklaratif memiliki properti yang PopulateOnDemand diatur ke false. Menggunakan sintaks deklaratif memungkinkan Anda mengontrol perilaku pengikatan data individual.
