MenuItemBindingCollection Kelas

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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.

Mewakili kumpulan MenuItemBinding objek.

public ref class MenuItemBindingCollection sealed : System::Web::UI::StateManagedCollection

public sealed class MenuItemBindingCollection : System.Web.UI.StateManagedCollection

type MenuItemBindingCollection = class
    inherit StateManagedCollection

Public NotInheritable Class MenuItemBindingCollection
Inherits StateManagedCollection

Warisan: Object

StateManagedCollection
MenuItemBindingCollection

Contoh

Contoh kode berikut menunjukkan cara mengisi MenuItemBindingCollection objek secara deklaratif. 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>

Contoh kode berikut menunjukkan cara menambahkan MenuItemBinding objek ke MenuItemBindingCollection objek secara terprogram. 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">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {
    if(!IsPostBack)
    {
      // Create the menu item bindings for the Menu control.
      MenuItemBinding binding;
      
      binding = CreateMenuItemBinding("MapHomeNode", 0, "title", "url");
      NavigationMenu.DataBindings.Add(binding);

      binding = CreateMenuItemBinding("MapNode", 1, "title", "url");
      NavigationMenu.DataBindings.Add(binding);

      binding = CreateMenuItemBinding("MapNode", 2, "title", "url");
      NavigationMenu.DataBindings.Add(binding);
    }
  }

  // This is a helper method to create a MenuItemBinding 
  // object from the specified parameters.
  MenuItemBinding CreateMenuItemBinding(String dataMember, int depth, String textField, String navigateUrlField)
  {
    // Create a new MenuItemBinding object.
    MenuItemBinding binding = new MenuItemBinding();

    // Set the properties of the MenuItemBinding object.
    binding.DataMember = dataMember;
    binding.Depth = depth;
    binding.TextField = textField;
    binding.NavigateUrlField = navigateUrlField;

    return binding;
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">        
      </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">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
 
    If Not IsPostBack Then
    
      ' Create the menu item bindings for the Menu control.
      Dim binding As MenuItemBinding
      
      binding = CreateMenuItemBinding("MapHomeNode", 0, "title", "url")
      NavigationMenu.DataBindings.Add(binding)

      binding = CreateMenuItemBinding("MapNode", 1, "title", "url")
      NavigationMenu.DataBindings.Add(binding)

      binding = CreateMenuItemBinding("MapNode", 2, "title", "url")
      NavigationMenu.DataBindings.Add(binding)
   
    End If
    
  End Sub

  ' This is a helper method to create a MenuItemBinding 
  ' object from the specified parameters.
  Function CreateMenuItemBinding(ByVal dataMember As String, ByVal depth As Integer, ByVal textField As String, ByVal navigateUrlField As String) As MenuItemBinding
  
    ' Create a new MenuItemBinding object.
    Dim binding As New MenuItemBinding()

    ' Set the properties of the MenuItemBinding object.
    binding.DataMember = dataMember
    binding.Depth = depth
    binding.TextField = textField
    binding.NavigateUrlField = navigateUrlField

    Return binding
    
  End Function
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">        
      </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

Kelas MenuItemBindingCollection ini digunakan untuk menyimpan dan mengelola kumpulan MenuItemBinding objek dalam Menu kontrol. Kontrol Menu menggunakan MenuItemBindingCollection kelas sebagai jenis data untuk propertinya DataBindings . Properti DataBindings digunakan untuk menyimpan pengikatan item menu apa pun yang ditentukan untuk Menu kontrol.

Nota

Urutan di mana MenuItemBinding objek muncul dalam koleksi tidak berpengaruh pada bagaimana objek tersebut diterapkan ke item menu dalam Menu kontrol.

Kelas MenuItemBindingCollection ini mendukung beberapa cara untuk mengakses item dalam koleksi:

Gunakan pengindeks Item[] untuk langsung mengambil objek pada MenuItemBinding indeks berbasis nol tertentu.
GetEnumerator Gunakan metode untuk membuat enumerator yang dapat digunakan untuk melakukan iterasi melalui koleksi.
CopyTo Gunakan metode untuk menyalin konten koleksi ke dalam array.

Anda dapat mengelola MenuItemBindingCollection objek secara terprogram dengan menambahkan dan menghapus MenuItemBinding objek. Untuk menambahkan item menu ke koleksi, gunakan Add atau Insert metode . Untuk menghapus simpul dari koleksi, gunakan Remove, , RemoveAtatau Clear metode .

Kelas MenuItemBindingCollection berisi properti dan metode yang memungkinkan Anda untuk mengambil informasi tentang koleksi itu sendiri. Untuk mengetahui berapa banyak item yang ada dalam koleksi, gunakan Count properti . Jika Anda ingin menentukan apakah koleksi berisi objek tertentuMenuItemBinding, gunakan metode .Contains Untuk mendapatkan indeks MenuItemBinding objek dalam koleksi, gunakan IndexOf metode .

Properti

Nama	Deskripsi
Count	Mendapatkan jumlah elemen yang terkandung dalam StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
Item[Int32]	MenuItemBinding Mendapatkan objek pada indeks yang ditentukan dari koleksi.

Metode

Nama	Deskripsi
Add(MenuItemBinding)	Menambahkan objek yang ditentukan MenuItemBinding ke akhir koleksi.
Clear()	Menghapus semua item dari StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
Contains(MenuItemBinding)	Menentukan apakah objek yang ditentukan MenuItemBinding ada dalam koleksi.
CopyTo(Array, Int32)	Menyalin elemen StateManagedCollection koleksi ke array, dimulai pada indeks array tertentu. (Diperoleh dari StateManagedCollection)
CopyTo(MenuItemBinding[], Int32)	Menyalin semua item dari MenuItemBindingCollection objek ke array MenuItemBinding objek satu dimensi yang kompatibel, dimulai dari indeks yang ditentukan dalam array target.
CreateKnownType(Int32)	Saat ditimpa dalam kelas turunan, membuat instans kelas yang mengimplementasikan IStateManager. Jenis objek yang dibuat didasarkan pada anggota koleksi yang ditentukan yang dikembalikan oleh GetKnownTypes() metode . (Diperoleh dari StateManagedCollection)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan iterator yang berulang melalui StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetKnownTypes()	Saat ditimpa dalam kelas turunan, mendapatkan array jenis IStateManager yang dapat dimuat StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IndexOf(MenuItemBinding)	Menentukan indeks objek yang ditentukan MenuItemBinding dalam koleksi.
Insert(Int32, MenuItemBinding)	Menambahkan objek yang ditentukan MenuItemBinding ke koleksi di lokasi indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnClear()	Saat ditimpa di kelas turunan, lakukan pekerjaan tambahan sebelum Clear() metode menghapus semua item dari koleksi. (Diperoleh dari StateManagedCollection)
OnClearComplete()	Ketika ditimpa di kelas turunan, lakukan pekerjaan tambahan setelah Clear() metode selesai menghapus semua item dari koleksi. (Diperoleh dari StateManagedCollection)
OnInsert(Int32, Object)	Saat ditimpa di kelas turunan, lakukan pekerjaan tambahan sebelum IList.Insert(Int32, Object) metode atau IList.Add(Object) menambahkan item ke koleksi. (Diperoleh dari StateManagedCollection)
OnInsertComplete(Int32, Object)	Saat ditimpa di kelas turunan, melakukan pekerjaan tambahan setelah IList.Insert(Int32, Object) metode atau IList.Add(Object) menambahkan item ke koleksi. (Diperoleh dari StateManagedCollection)
OnRemove(Int32, Object)	Saat ditimpa di kelas turunan, melakukan pekerjaan tambahan sebelum IList.Remove(Object) metode atau IList.RemoveAt(Int32) menghapus item yang ditentukan dari koleksi. (Diperoleh dari StateManagedCollection)
OnRemoveComplete(Int32, Object)	Saat ditimpa di kelas turunan, melakukan pekerjaan tambahan setelah IList.Remove(Object) metode atau IList.RemoveAt(Int32) menghapus item yang ditentukan dari koleksi. (Diperoleh dari StateManagedCollection)
OnValidate(Object)	Ketika ditimpa dalam kelas turunan, memvalidasi elemen StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
Remove(MenuItemBinding)	Menghapus objek yang ditentukan MenuItemBinding dari koleksi.
RemoveAt(Int32)	MenuItemBinding Menghapus objek di lokasi indeks yang ditentukan dari koleksi.
SetDirty()	Memaksa seluruh StateManagedCollection koleksi untuk diserialisasikan ke dalam status tampilan. (Diperoleh dari StateManagedCollection)
SetDirtyObject(Object)	Ketika ditimpa dalam kelas turunan, menginstruksikan yang `object` dimuat oleh koleksi untuk merekam seluruh statusnya untuk melihat status, daripada merekam hanya mengubah informasi. (Diperoleh dari StateManagedCollection)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICollection.Count	Mendapatkan jumlah elemen yang terkandung dalam StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah koleksi disinkronkan StateManagedCollection (utas aman). Metode ini mengembalikan `false` dalam semua kasus. (Diperoleh dari StateManagedCollection)
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke StateManagedCollection koleksi. Metode ini mengembalikan `null` dalam semua kasus. (Diperoleh dari StateManagedCollection)
IEnumerable.GetEnumerator()	Mengembalikan iterator yang berulang melalui StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
IList.Add(Object)	Menambahkan item ke StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
IList.Clear()	Menghapus semua item dari StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
IList.Contains(Object)	Menentukan apakah StateManagedCollection koleksi berisi nilai tertentu. (Diperoleh dari StateManagedCollection)
IList.IndexOf(Object)	Menentukan indeks item yang ditentukan dalam StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
IList.Insert(Int32, Object)	Menyisipkan item ke StateManagedCollection dalam koleksi pada indeks yang ditentukan. (Diperoleh dari StateManagedCollection)
IList.IsFixedSize	Mendapatkan nilai yang menunjukkan apakah StateManagedCollection koleksi memiliki ukuran tetap. Metode ini mengembalikan `false` dalam semua kasus. (Diperoleh dari StateManagedCollection)
IList.IsReadOnly	Mendapatkan nilai yang menunjukkan apakah StateManagedCollection koleksi bersifat baca-saja. (Diperoleh dari StateManagedCollection)
IList.Item[Int32]	IStateManager Mendapatkan elemen pada indeks yang ditentukan. (Diperoleh dari StateManagedCollection)
IList.Remove(Object)	Menghapus kemunculan pertama objek yang ditentukan dari StateManagedCollection koleksi. (Diperoleh dari StateManagedCollection)
IList.RemoveAt(Int32)	IStateManager Menghapus elemen pada indeks yang ditentukan. (Diperoleh dari StateManagedCollection)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah StateManagedCollection koleksi menyimpan perubahan pada status tampilannya. (Diperoleh dari StateManagedCollection)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan koleksi yang StateManagedCollection disimpan sebelumnya dan item yang dikandungnya IStateManager . (Diperoleh dari StateManagedCollection)
IStateManager.SaveViewState()	Menyimpan perubahan pada StateManagedCollection koleksi dan setiap IStateManager objek yang dikandungnya sejak halaman diposting kembali ke server. (Diperoleh dari StateManagedCollection)
IStateManager.TrackViewState()	StateManagedCollection Menyebabkan koleksi dan setiap objek yang dikandungnya IStateManager untuk melacak perubahan pada status tampilannya sehingga dapat dipertahankan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari StateManagedCollection)

Metode Ekstensi

Nama	Deskripsi
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi IEnumerable menjadi IQueryable.
Cast<TResult>(IEnumerable)	Melemparkan elemen IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen IEnumerable berdasarkan jenis tertentu.

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?