Menu.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 MenuItemBinding objek yang menentukan hubungan antara item data dan item menu yang mengikatnya.
public:
property System::Web::UI::WebControls::MenuItemBindingCollection ^ DataBindings { System::Web::UI::WebControls::MenuItemBindingCollection ^ get(); };[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.MenuItemBindingCollection DataBindings { get; }[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DataBindings : System.Web.UI.WebControls.MenuItemBindingCollectionPublic ReadOnly Property DataBindings As MenuItemBindingCollectionNilai Properti
MenuItemBindingCollection yang mewakili hubungan antara item data dan item menu yang diikatnya.
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan DataBindings koleksi untuk menentukan hubungan antara bidang XmlDataSource kontrol dan item menu dalam Menu kontrol. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data XML sampel di bawah ini ke file bernama Map.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>Menu DataBindings Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu DataBindings Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
depth="0"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</asp:menu>
<asp:XmlDataSource id="MenuSource"
datafile="Map.xml"
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>Menu DataBindings Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu DataBindings Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
depth="0"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</asp:menu>
<asp:XmlDataSource id="MenuSource"
datafile="Map.xml"
runat="server"/>
</form>
</body>
</html>
Berikut ini adalah contoh data peta situs untuk contoh sebelumnya.
<MapHomeNode url="~\Home.aspx"
title="Home"
description="Home">
<MapNode url="~\Music.aspx"
title="Music"
description="Music">
<MapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<MapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<MapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</MapNode>
<MapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<MapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<MapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<MapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</MapNode>
</MapHomeNode>
Keterangan
Koleksi DataBindings berisi MenuItemBinding objek yang menentukan hubungan antara item data dan item menu yang diikatnya. Saat mengikat ke sumber data di mana setiap item data berisi beberapa properti (seperti elemen XML dengan beberapa atribut), item menu menampilkan nilai yang dikembalikan oleh ToString() metode item data secara default. Dalam kasus elemen XML, item menu menampilkan nama elemen, yang menunjukkan struktur pohon yang mendasar, tetapi tidak terlalu berguna sebaliknya. Anda dapat mengikat item menu ke properti item data tertentu dengan menentukan pengikatan item menu.
Saat menentukan hubungan antara item data dan item menu, Anda harus menentukan kriteria untuk pengikatan dan properti item data yang akan diikat. Kriteria menunjukkan kapan item data harus terikat ke item menu. Kriteria dapat ditentukan dengan kedalaman, anggota data, atau keduanya. Kedalaman menentukan tingkat menu yang terikat. Misalnya, jika Anda menentukan kedalaman 0, semua item menu dalam struktur pohon pada tingkat 0 terikat menggunakan pengikatan item menu. 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 MenuItemBinding objek didefinisikan yang bertentangan satu sama lain, Menu kontrol menerapkan pengikatan item menu dalam urutan prioritas berikut:
Objek MenuItemBinding yang menentukan kedalaman dan anggota data.
Objek MenuItemBinding yang hanya mendefinisikan kedalaman.
Objek MenuItemBinding yang hanya menentukan anggota data.
Objek MenuItemBinding yang mendefinisikan kedalaman atau anggota data.
Setelah kriteria pengikatan dibuat, Anda kemudian dapat mengikat properti MenuItem objek yang dapat terikat ke atribut atau bidang item data. Misalnya, Anda dapat mengikat Text properti item menu ke atribut teks pada elemen XML dengan mengatur TextField properti MenuItemBinding objek. Anda juga dapat mengikat ke nilai statis. Jika Anda mengatur Text properti MenuItemBinding objek, semua item menu tempat MenuItemBinding objek diterapkan berbagi nilai teks statis yang sama. Untuk informasi selengkapnya tentang mengikat properti MenuItem objek ke nilai, lihat MenuItemBinding.
DataBindings Meskipun koleksi dapat diisi secara terprogram, biasanya diatur secara deklaratif. Untuk menentukan pengikatan item menu, tag pembukaan dan penutupan <DataBindings> sarang pertama antara tag Menu pembuka dan penutup kontrol. Selanjutnya, tempatkan <asp:MenuItemBinding> elemen antara tag pembuka dan penutup <DataBindings> untuk setiap pengikatan item menu yang ingin Anda tentukan.
