MenuItem.ValuePath Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera ścieżkę z elementu menu głównego do bieżącego elementu menu.
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 StringWartość właściwości
Rozdzielona ogranicznikami lista wartości elementów menu, które tworzą ścieżkę z elementu menu głównego do bieżącego elementu menu.
- Atrybuty
Przykłady
W poniższym przykładzie pokazano, jak przeanalizować wartość ValuePath właściwości dla poszczególnych wartości elementów menu.
<%@ 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>
Uwagi
Właściwość ValuePath zawiera rozdzielaną ogranicznikami listę wartości elementów menu, które tworzą ścieżkę z elementu menu głównego do bieżącego elementu menu. Ścieżka wartości służy do wskazywania położenia elementu menu w kontrolce Menu . Można określić znak ogranicznika używany do oddzielania wartości elementów menu za pomocą PathSeparator właściwości . Ta wartość jest często używana podczas analizowania listy dla poszczególnych wartości lub przekazywania jako argumentu do FindItem metody TreeView klasy. W zależności od wartości wyświetlanej w kontrolce Menu może być konieczne zmianę znaku ogranicznika, aby zapobiec konfliktom. Jeśli na przykład ustawisz znak ogranicznika na przecinek, wyświetlana wartość nie powinna zawierać żadnych przecinków; w przeciwnym razie nie można dokładnie przeanalizować ValuePath właściwości.
Uwaga
Wartości Value właściwości każdego elementu menu z elementu menu głównego do bieżącego elementu menu są używane do generowania ścieżki wartości. Elementy menu na tym samym poziomie menu muszą mieć unikatową wartość właściwości Value . Kontrolka Menu nie może odróżnić różnych elementów menu na tym samym poziomie, które mają tę samą wartość.
