MenuEventArgs 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.

Menyediakan data untuk MenuItemClick peristiwa MenuItemDataBound dan Menu kontrol. Kelas ini tidak dapat diwariskan.

public ref class MenuEventArgs sealed : System::Web::UI::WebControls::CommandEventArgs

public sealed class MenuEventArgs : System.Web.UI.WebControls.CommandEventArgs

type MenuEventArgs = class
    inherit CommandEventArgs

Public NotInheritable Class MenuEventArgs
Inherits CommandEventArgs

Warisan: Object

EventArgs

CommandEventArgs
MenuEventArgs

Contoh

Contoh kode berikut menunjukkan cara menggunakan objek yang MenuEventArgs diteruskan ke penanganan aktivitas untuk MenuItemDataBound peristiwa guna memodifikasi properti item menu sebelum ditampilkan dalam Menu kontrol. Properti ImageUrlHome item menu diatur untuk menampilkan gambar dalam item menu tersebut saja. Agar contoh ini berfungsi dengan benar, Anda harus menyalin data peta situs sampel di bawah 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">
<script runat="server">

  void MenuItemDataBound_NavigationMenu(Object sender, MenuEventArgs e)
  {
    // Display an image for the Home menu item only by
    // setting its ImageUrl property.
    if (e.Item.Text == "Home")
    {
      // Use an @-quoted string to bypass the escape sequence
      // processing.
      e.Item.ImageUrl = @"Images\Home.jpg";
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuEventArgs Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        datasourceid="menusource" 
        onmenuitemdatabound="MenuItemDataBound_NavigationMenu" 
        runat="server">

      </asp:menu>
      
      <asp:SiteMapDataSource id="MenuSource"
        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 MenuItemDataBound_NavigationMenu(ByVal sender As Object, ByVal e As MenuEventArgs)
  
    ' Display an image for the Home menu item only by
    ' setting its ImageUrl property.
    If e.Item.Text = "Home" Then
    
      e.Item.ImageUrl = "Images\Home.jpg"
      
    End If
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuEventArgs Example</title>
</head>
<body>
    <form id="Form1" runat="server">
    
      <h3>MenuEventArgs Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        datasourceid="menusource" 
        onmenuitemdatabound="MenuItemDataBound_NavigationMenu" 
        runat="server">

      </asp:menu>
      
      <asp:SiteMapDataSource id="MenuSource"
        Runat="server"/>

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

Berikut ini adalah contoh data peta situs untuk contoh sebelumnya.

<siteMap>

<siteMapNode url="~\Home.aspx"

title="Home"

description="Home">

<siteMapNode url="~\Music.aspx"

title="Music"

description="Music">

<siteMapNode url="~\Classical.aspx"

title="Classical"

description="Classical"/>

<siteMapNode url="~\Rock.aspx"

title="Rock"

description="Rock"/>

<siteMapNode url="~\Jazz.aspx"

title="Jazz"

description="Jazz"/>

</siteMapNode>

<siteMapNode url="~\Movies.aspx"

title="Movies"

description="Movies">

<siteMapNode url="~\Action.aspx"

title="Action"

description="Action"/>

<siteMapNode url="~\Drama.aspx"

title="Drama"

description="Drama"/>

<siteMapNode url="~\Musical.aspx"

title="Musical"

description="Musical"/>

</siteMapNode>

</siteMap>

Keterangan

Kelas MenuEventArgs digunakan untuk menyimpan data peristiwa yang diteruskan ke penanganan aktivitas untuk peristiwa dalam tabel berikut.

Event	Deskripsi
MenuItemClick	Terjadi saat item menu diklik. Kejadian ini biasanya digunakan untuk menyinkronkan Menu kontrol dengan kontrol lain pada halaman.
MenuItemDataBound	Terjadi saat item menu terikat ke data. Kejadian ini biasanya digunakan untuk memodifikasi item menu sebelum dirender dalam Menu kontrol.

Bergantung pada peristiwa yang dinaikkan, Anda dapat mengakses item menu yang diklik oleh pengguna atau item menu yang terikat ke data dengan menggunakan Item properti .

Untuk daftar nilai properti awal untuk instans kelas MenuEventArgs, lihat konstruktor MenuEventArgs.

Konstruktor

Nama	Deskripsi
MenuEventArgs(MenuItem, Object, CommandEventArgs)	Menginisialisasi instans MenuEventArgs baru kelas menggunakan item menu, sumber perintah, dan argumen peristiwa yang ditentukan.
MenuEventArgs(MenuItem)	Menginisialisasi instans MenuEventArgs baru kelas menggunakan item menu yang ditentukan.

Properti

Nama	Deskripsi
CommandArgument	Mendapatkan argumen untuk perintah . (Diperoleh dari CommandEventArgs)
CommandName	Mendapatkan nama perintah. (Diperoleh dari CommandEventArgs)
CommandSource	Object Mendapatkan yang memunculkan peristiwa.
Item	Mendapatkan item menu yang terkait dengan peristiwa yang dinaikkan.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?