MenuItem.ValuePath 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取从根菜单项到当前菜单项的路径。
public:
property System::String ^ ValuePath { System::String ^ get(); };[System.ComponentModel.Browsable(false)]
public string ValuePath { get; }[<System.ComponentModel.Browsable(false)>]
member this.ValuePath : stringPublic ReadOnly Property ValuePath As String属性值
由分隔符分隔的菜单项值的列表，它构成了从根菜单项到当前菜单项的路径。
- 属性
示例
以下示例演示如何将值分析为 ValuePath 单个菜单项值的属性。
<%@ 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)
{
// Get the Classical menu item using the Items
// and ChildItems collections.
MenuItem item = NavigationMenu.Items[0].ChildItems[0].ChildItems[0];
// Create the delimiter array using the PathSeparator value.
// This array is used by the Split method to parse the
// value path string.
Char[] DelimiterArray = new Char[1];
DelimiterArray[0] = NavigationMenu.PathSeparator;
// Parse the value path of the Classical menu item
// using the Split method.
String[] nodeValues = item.ValuePath.Split(DelimiterArray);
// Display the original and parsed values.
Message.Text = "The original value path for the Classical menu item is <b>" +
item.ValuePath + "</b>.<br/>";
Message.Text += "The individual values that make up the value " +
"path are: <br/>";
foreach (String menuValue in nodeValues)
{
Message.Text += "- <b>" + menuValue + "</b><br/>";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem ValuePath Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem ValuePath Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
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>
<hr/>
<asp:label id="Message"
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 Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Get the Classical menu item using the Items
' and ChildItems collections.
Dim item As MenuItem = NavigationMenu.Items(0).ChildItems(0).ChildItems(0)
' Create the delimiter array using the PathSeparator value.
' This array is used by the Split method to parse the
' value path string.
Dim DelimiterArray(1) As Char
DelimiterArray(0) = NavigationMenu.PathSeparator
' Parse the value path of the Classical menu item
' using the Split method.
Dim nodeValues() As String = item.ValuePath.Split(DelimiterArray)
' Display the original and parsed values.
Message.Text = "The original value path for the Classical menu item is <b>" & _
item.ValuePath & "</b>.<br/>"
Message.Text &= "The individual values that make up the value " & _
"path are: <br/>"
Dim menuValue As String
For Each menuValue In nodeValues
Message.Text &= "- <b>" & menuValue & "</b><br/>"
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItem ValuePath Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem ValuePath Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
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>
<hr/>
<asp:label id="Message"
runat="server"/>
</form>
</body>
</html>
注解
该 ValuePath 属性包含一个分隔符分隔的菜单项值列表，该列表构成从根菜单项到当前菜单项的路径。 值路径用于指示菜单项在控件中 Menu 的位置。 可以使用属性指定用于分隔菜单项值的 PathSeparator 分隔符字符。 在分析各个值的列表时，通常使用此值，或作为参数 FindItem 传递给类的方法 TreeView 。 根据控件中显示的 Menu 值，可能需要更改分隔符字符以防止发生任何冲突。 例如，如果将分隔符字符设置为逗号，则显示的值不应包含任何逗号;否则，无法准确分析 ValuePath 属性。