MenuEventArgs 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

提供資料給 MenuItemClick 控制項的 MenuItemDataBound 和 Menu 事件。 此類別無法獲得繼承。

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
繼承
Object
EventArgs
CommandEventArgs
MenuEventArgs

範例

下列程式碼範例示範如何使用 MenuEventArgs 傳遞給事件的事件處理常式 MenuItemDataBound 物件，在控制項中 Menu 顯示功能表項目之前修改功能表項目的屬性。 ImageUrl功能表項目的 Home 屬性設定為只顯示該功能表項目中的影像。 若要讓此範例正常運作，您必須將下面的範例網站地圖資料複製到名為 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>

以下是先前範例的範例網站地圖資料。

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

</siteMapNode>

</siteMap>

備註

類別 MenuEventArgs 是用來儲存下表中事件傳遞至事件處理常式的事件資料。

事件 描述
MenuItemClick 發生于按一下功能表項目時。 這個事件通常用來同步 Menu 處理控制項與頁面上的另一個控制項。
MenuItemDataBound 發生于功能表項目系結至資料時。 此事件通常用於在控制項中 Menu 轉譯功能表項目之前修改功能表項目。

視引發的事件而定，您可以使用 屬性來存取使用者按一下的功能表項目或系結至資料的 Item 功能表項目。

如需 MenuEventArgs 類別之執行個體的初始屬性值清單，請參閱 MenuEventArgs 建構函式。

建構函式

MenuEventArgs(MenuItem)

使用指定的功能表項目，初始化 MenuEventArgs 類別的新執行個體。
MenuEventArgs(MenuItem, Object, CommandEventArgs)

使用指定的功能表項目、命令來源和事件引數，初始化 MenuEventArgs 類別的新執行個體。

屬性

CommandArgument

取得命令的引數。

(繼承來源 CommandEventArgs)
CommandName

取得命令的名稱。

(繼承來源 CommandEventArgs)
CommandSource

取得引發事件的 Object。
Item

取得與所引發事件關聯的功能表項目。

方法

Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetType()

取得目前執行個體的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)

適用於

另請參閱