MenuEventArgs クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MenuEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Menu コントロールの MenuItemClick イベントと MenuItemDataBound イベントのデータを提供します。このクラスは継承できません。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 MenuEventArgs
    Inherits CommandEventArgs

Visual Basic (使用法)

Dim instance As MenuEventArgs

public sealed class MenuEventArgs : CommandEventArgs

C++

public ref class MenuEventArgs sealed : public
 CommandEventArgs

public final class MenuEventArgs extends CommandEventArgs

JScript

public final class MenuEventArgs extends
 CommandEventArgs

解説

MenuEventArgs クラスは、次の表に示すイベントのイベントハンドラに渡されるイベントデータを格納するために使用されます。

イベント	説明
MenuItemClick	メニュー項目がクリックされると発生します。通常このイベントは、Menu コントロールをページ上の別のコントロールと同期する場合に使用されます。
MenuItemDataBound	メニュー項目がデータにバインドされると発生します。通常このイベントは、メニュー項目が Menu コントロールに表示される前にメニュー項目を変更する場合に使用されます。

発生したイベントに応じて、ユーザーがクリックしたメニュー項目、または Item プロパティを使用してデータにバインドされるメニュー項目にアクセスできます。

MenuEventArgs クラスのインスタンスの初期プロパティ値の一覧については、MenuEventArgs コンストラクタのトピックを参照してください。

使用例

MenuItemDataBound イベントのイベントハンドラに渡される MenuEventArgs オブジェクトを使用して、メニュー項目を Menu コントロールに表示する前に、メニュー項目のプロパティを変更する方法のコード例を次に示します。Home メニュー項目の ImageUrl プロパティは、そのメニュー項目だけにイメージを表示する場合に設定されます。この例を正常に動作させるには、以下のサンプルサイトマップデータを、Web.sitemap という名前のファイルにコピーする必要があります。

Visual Basic

<%@ Page Language="VB" %>

<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>
  <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="C#" %>

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

</siteMap>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.EventArgs
     System.Web.UI.WebControls.CommandEventArgs
      System.Web.UI.WebControls.MenuEventArgs

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MenuEventArgs メンバ
System.Web.UI.WebControls 名前空間
Menu クラス
MenuItem
MenuEventHandler
Menu.MenuItemClick イベント
OnMenuItemClick
Menu.MenuItemDataBound イベント
OnMenuItemDataBound

>> 「MenuEventArgs クラス」を含む用語の索引
MenuEventArgs クラスのページへのリンク

MenuEventArgs クラスとは？わかりやすく解説