MenuItemBinding.Value 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 lub ustawia niezdyskrywałą wartość używaną do przechowywania wszelkich dodatkowych danych dotyczących elementu menu, do którego MenuItemBinding jest stosowany obiekt, takich jak dane używane do obsługi zdarzeń ogłaszania zwrotnego.
public:
property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };public string Value { get; set; }member this.Value : string with get, setPublic Property Value As StringWartość właściwości
Dane uzupełniające dotyczące elementu menu, do którego MenuItemBinding jest stosowany; te dane nie są wyświetlane. Wartość domyślna to pusty ciąg (""), który wskazuje, że ta właściwość nie jest ustawiona.
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą Value właściwości określić wartość niezwiązaną z elementem menu. Ta wartość jest używana w każdym elemencie menu, do którego MenuItemBinding jest stosowany obiekt. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML poniżej do pliku o nazwie Menu.xml.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<databindings>
<asp:menuitembinding datamember="MapHomeNode"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
text="Static Title"
value="Static Description"
imageurl="~\Images\StaticImage.jpg"
tooltip="Static ToolTip"/>
</databindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<databindings>
<asp:menuitembinding datamember="MapHomeNode"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
text="Static Title"
value="Static Description"
imageurl="~\Images\StaticImage.jpg"
tooltip="Static ToolTip"/>
</databindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
Poniższy kod to przykładowe dane mapy witryny dla poprzedniego przykładu.
<MapHomeNode ImageUrl="~\Images\Home.gif"
Title="Home"
Description="Root Page"
ToolTip="Home Page">
<MapNode ImageUrl="~\Images\Music.gif"
Title="Music"
Description="Music Category"
ToolTip="Music Page">
<MapNode ImageUrl="~\Images\Classical.gif"
Title="Classical"
Description="Classical Section"
ToolTip="Classical Page"/>
<MapNode ImageUrl="~\Images\Rock.gif"
Title="Rock"
Description="Rock Section"
ToolTip="Rock Page"/>
<MapNode ImageUrl="~\Images\Jazz.gif"
Title="Jazz"
Description="Jazz Section"
ToolTip="Jazz Page"/>
</MapNode>
<MapNode ImageUrl="~\Images\Movies.gif"
Title="Movies"
Description="Movies Category"
ToolTip="Movies Page">
<MapNode ImageUrl="~\Images\Action.gif"
Title="Action"
Description="Action Section"
ToolTip="Action Page"/>
<MapNode ImageUrl="~\Images\Drama.gif"
Title="Drama"
Description="Drama Section"
ToolTip="Drama Page"/>
<MapNode ImageUrl="~\Images\Musical.gif"
Title="Musical"
Description="Musical Section"
ToolTip="Musical Page"/>
</MapNode>
</MapHomeNode>
Uwagi
Gdy kontrolka Menu jest powiązana ze źródłem danych, użyj Value właściwości , aby określić wartość, która ma być powiązana MenuItem.Value z właściwością MenuItem obiektu. Ta wartość jest udostępniana wszystkim elementom menu, do których MenuItemBinding jest stosowany obiekt. Określona wartość nie jest wyświetlana w elemencie menu i służy do przechowywania dodatkowych danych dotyczących elementu menu, do którego MenuItemBinding jest stosowany obiekt, takich jak dane używane do obsługi zdarzeń ogłaszania zwrotnego.
Uwaga
Możesz zastąpić wartość pojedynczego elementu menu, ustawiając jego Value właściwość bezpośrednio.
Zamiast używać tej właściwości do określania tej samej wartości dla każdego elementu menu, można również powiązać Value właściwość MenuItem obiektu z polem źródła danych, ustawiając ValueField właściwość . Podczas renderowania właściwość każdego elementu menu, do którego MenuItemBinding jest stosowany obiekt, Value zawiera odpowiednią wartość z pola.
Uwaga
Jeśli właściwości Value i ValueField są ustawione, ValueField właściwość ma pierwszeństwo.
Wartość tej właściwości, po ustawieniu, można automatycznie zapisać w pliku zasobów za pomocą narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttributeGlobalization and Localization (Globalizacja i lokalizacja).
