MenuItem.Value プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文[LocalizableAttribute(true)] public: property String^ Value { String^ get (); void set (String^ value); }
メニュー項目に関する非表示の補足データ。既定値は空の文字列 ("") です。
解説Value プロパティを使用して、メニュー項目に関連付けられた補足データを格納することにより、Text プロパティを補足します。この値はコントロールには表示されず、ポストバック イベントを処理するためのデータを格納するために使用されるのが一般的です。
.gif) メモ |
|---|
| Value プロパティに null 参照 (Visual Basic では Nothing) が格納されている場合、get アクセサは Text プロパティの値を返します。さらに、Text プロパティに null 参照 (Visual Basic では Nothing) が格納されている場合は、Empty が返されます。 |
Value プロパティの値は、ValuePath プロパティで指定された値パスが生成されるときにも使用されます。値パスは、ルート メニュー項目から現在のメニュー項目までのパスを構成するメニュー項目の値のコンマ区切りのリストです。値パスは、Menu コントロール内でのメニュー項目の位置を示すために使用されます。
| メモ |
|---|
| 同じメニュー レベルにあるメニュー項目は、それぞれの Value プロパティの値が一意であることが必要です。同一レベルの複数のメニュー項目でこの値が同じであると、Menu コントロールは各メニュー項目を区別できません。 |
このプロパティの値は、設定時に、デザイナ ツールを使用してリソース ファイルに自動的に保存できます。詳細については、LocalizableAttribute、ASP.NET のグローバリゼーションおよびローカリゼーション の各トピックを参照してください。
使用例ユーザーがメニュー項目を選択したときに、メニュー項目の Value とその親を表示する方法のコード例を次に示します。
<%@ Page Language="VB" %> <script runat="server"> Sub NavigationMenu_MenuItemClick(ByVal sender As Object, ByVal e As MenuEventArgs) ' Display the selected menu item. If e.Item.Parent IsNot Nothing Then Message.Text = "You selected " & e.Item.Value & _ " from " & e.Item.Parent.Value & "." Else Message.Text = "You selected " & e.Item.Value & "." End If End Sub </script> <html> <body> <form runat="server"> <h3>MenuItem Value Example</h3> Select an item from the menu:<br/><br/> <asp:menu id="NavigationMenu" staticdisplaylevels="1" staticsubmenuindent="10" orientation="Vertical" onmenuitemclick="NavigationMenu_MenuItemClick" runat="server"> <dynamicselectedstyle backcolor="yellow"/> <staticselectedstyle backcolor="yellow"/> <items> <asp:menuitem text="Home" tooltip="Home"> <asp:menuitem text="Category" value="Category 1" tooltip="Category 1"> <asp:menuitem text="Topic" value="Topic 1" tooltip="Topic 1"/> <asp:menuitem text="Topic" value="Topic 2" tooltip="Topic 2"/> <asp:menuitem text="Topic" value="Topic 3" tooltip="Topic 3"/> </asp:menuitem> <asp:menuitem text="Category" value="Category 2" tooltip="Category 2"> <asp:menuitem text="Topic" value="Topic 1" tooltip="Topic 1"/> <asp:menuitem text="Topic" value="Topic 2" tooltip="Topic 2"/> <asp:menuitem text="Topic" value="Topic 3" tooltip="Topic 3"/> </asp:menuitem> </asp:menuitem> </items> </asp:menu> <hr/> <asp:label id="Message" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" %> <script runat="server"> void NavigationMenu_MenuItemClick(Object sender, MenuEventArgs e) { // Display the selected menu item. if (e.Item.Parent != null) { Message.Text = "You selected " + e.Item.Value + " from " + e.Item.Parent.Value + "."; } else { Message.Text = "You selected " + e.Item.Value + "."; } } </script> <html> <body> <form runat="server"> <h3>MenuItem Value Example</h3> Select an item from the menu:<br/><br/> <asp:menu id="NavigationMenu" staticdisplaylevels="1" staticsubmenuindent="10" orientation="Vertical" onmenuitemclick="NavigationMenu_MenuItemClick" runat="server"> <dynamicselectedstyle backcolor="yellow"/> <staticselectedstyle backcolor="yellow"/> <items> <asp:menuitem text="Home" tooltip="Home"> <asp:menuitem text="Category" value="Category 1" tooltip="Category 1"> <asp:menuitem text="Topic" value="Topic 1" tooltip="Topic 1"/> <asp:menuitem text="Topic" value="Topic 2" tooltip="Topic 2"/> <asp:menuitem text="Topic" value="Topic 3" tooltip="Topic 3"/> </asp:menuitem> <asp:menuitem text="Category" value="Category 2" tooltip="Category 2"> <asp:menuitem text="Topic" value="Topic 1" tooltip="Topic 1"/> <asp:menuitem text="Topic" value="Topic 2" tooltip="Topic 2"/> <asp:menuitem text="Topic" value="Topic 3" tooltip="Topic 3"/> </asp:menuitem> </asp:menuitem> </items> </asp:menu> <hr/> <asp:label id="Message" runat="server"/> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からMenuItem.Value プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からMenuItem.Value プロパティ
を検索
- MenuItem.Value プロパティのページへのリンク
