MenuItemCollection 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 item menu dalam Menu kontrol. Kelas ini tidak dapat diwariskan.

public ref class MenuItemCollection sealed : System::Collections::ICollection, System::Web::UI::IStateManager

public sealed class MenuItemCollection : System.Collections.ICollection, System.Web.UI.IStateManager

type MenuItemCollection = class
    interface ICollection
    interface IEnumerable
    interface IStateManager

Public NotInheritable Class MenuItemCollection
Implements ICollection, IStateManager

Warisan: Object
MenuItemCollection

Penerapan: ICollection IEnumerable IStateManager

Contoh

Contoh kode berikut menunjukkan cara mengisi Items koleksi dan ChildItems menggunakan sintaks deklaratif.


<%@ 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" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu Declarative Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Submenu items are      -->
      <!-- created by nesting them in parent menu -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"  
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

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

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>Menu Declarative Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>Menu Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Submenu items are      -->
      <!-- created by nesting them in parent menu -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        disappearafter="2000"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        font-names="Arial" 
        target="_blank"  
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"/>
        <dynamicmenuitemstyle backcolor="Black"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          forecolor="Black"/>
      
        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>

Contoh kode berikut menunjukkan cara menambahkan MenuItem objek secara terprogram ke ChildItems kumpulan item menu akar.


<%@ 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)
    {
      // Retrieve the root menu item from the Items
      // collection of the Menu control using the indexer.
      MenuItem homeMenuItem = NavigationMenu.Items[0];

      // Create the submenu item.
      MenuItem newSubMenuItem = new MenuItem("New Category");

      // Add the submenu item to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(newSubMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

      </asp:menu>

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

      ' Retrieve the root menu item from the Items
      ' collection of the Menu control using the indexer.
      Dim homeMenuItem As MenuItem = NavigationMenu.Items(0)

      ' Create the submenu item.
      Dim newSubMenuItem = New MenuItem("New Category")

      ' Add the submenu item to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(newSubMenuItem)
    
    End If
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

      </asp:menu>

    </form>
  </body>
</html>

Keterangan

Kelas MenuItemCollection ini digunakan untuk menyimpan dan mengelola kumpulan MenuItem objek dalam Menu kontrol. Kontrol Menu menggunakan MenuItemCollection kelas untuk menyimpan item menu akarnya di Items properti . Koleksi ini juga digunakan untuk ChildItems properti MenuItem objek untuk menyimpan item submenu item menu (jika ada).

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

Gunakan pengindeks Item[] untuk langsung mengambil MenuItem objek pada 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 MenuItemCollection objek secara terprogram dengan menambahkan dan menghapus MenuItem objek. Untuk menambahkan item menu ke koleksi, gunakan Add atau AddAt metode . Untuk menghapus simpul dari koleksi, gunakan Remove, , RemoveAtatau Clear metode .

Nota

Menu Ketika kontrol terikat ke sumber data, Items koleksi dan ChildItems secara otomatis diisi setiap kali pengikatan terjadi. Setiap perubahan pada koleksi di antara pengikatan akan hilang. Untuk mempertahankan perubahan ini, perbarui sumber data atau bangun ulang koleksi secara manual setiap kali Anda mengikat.

Kelas MenuItemCollection 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 tertentuMenuItem, gunakan metode .Contains Untuk mendapatkan indeks MenuItem objek dalam koleksi, gunakan IndexOf metode .

Konstruktor

Nama	Deskripsi
MenuItemCollection()	Menginisialisasi instans MenuItemCollection baru kelas menggunakan nilai default.
MenuItemCollection(MenuItem)	Menginisialisasi instans MenuItemCollection baru kelas menggunakan item menu induk yang ditentukan (atau pemilik).

Properti

Nama	Deskripsi
Count	Mendapatkan jumlah item menu yang terkandung dalam objek saat ini MenuItemCollection .
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke objek disinkronkan MenuItemCollection (utas aman).
Item[Int32]	MenuItem Mendapatkan objek pada indeks yang ditentukan dalam objek saat iniMenuItemCollection.
SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke MenuItemCollection objek.

Metode

Nama	Deskripsi
Add(MenuItem)	Menambahkan objek yang ditentukan MenuItem ke akhir objek saat ini MenuItemCollection .
AddAt(Int32, MenuItem)	Menyisipkan objek yang ditentukan MenuItem dalam objek saat ini MenuItemCollection pada lokasi indeks yang ditentukan.
Clear()	Menghapus semua item dari objek saat ini MenuItemCollection .
Contains(MenuItem)	Menentukan apakah objek yang ditentukan MenuItem ada dalam koleksi.
CopyTo(Array, Int32)	Menyalin semua item dari MenuItemCollection objek ke satu dimensi Arrayyang kompatibel, dimulai dari indeks yang ditentukan dalam array target.
CopyTo(MenuItem[], Int32)	Menyalin semua item dari MenuItemCollection objek ke array MenuItem objek satu dimensi yang kompatibel, dimulai dari indeks yang ditentukan dalam array target.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan enumerator yang dapat digunakan untuk melakukan iterasi melalui item dalam objek saat ini MenuItemCollection .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IndexOf(MenuItem)	Menentukan indeks objek yang ditentukan MenuItem dalam koleksi.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Remove(MenuItem)	Menghapus objek yang ditentukan MenuItem dari MenuItemCollection objek.
RemoveAt(Int32)	MenuItem Menghapus objek pada lokasi indeks yang ditentukan dari objek saat iniMenuItemCollection.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah MenuItemCollection objek menyimpan perubahan pada status tampilannya.
IStateManager.LoadViewState(Object)	MenuItemCollection Memuat status tampilan objek yang disimpan sebelumnya.
IStateManager.SaveViewState()	Menyimpan perubahan untuk melihat status ke Object.
IStateManager.TrackViewState()	Menginstruksikan MenuItemCollection objek untuk melacak perubahan pada status tampilannya.

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?