MenuItemBinding.Value Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een niet-weergegeven waarde op die wordt gebruikt voor het opslaan van extra gegevens over een menu-item waarop het MenuItemBinding object wordt toegepast, zoals gegevens die worden gebruikt voor het verwerken van terugvalgebeurtenissen.
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 StringWaarde van eigenschap
Aanvullende gegevens over een menu-item waarop de MenuItemBinding toepassing is toegepast; deze gegevens worden niet weergegeven. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de Value eigenschap gebruikt om een niet-weergegeven waarde op te geven die is gekoppeld aan een menu-item. Deze waarde wordt gebruikt in elk menu-item waarop het MenuItemBinding object wordt toegepast. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens hieronder kopiëren naar een bestand met de naam 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>
De volgende code is voorbeeld van siteoverzichtsgegevens voor het vorige voorbeeld.
<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>
Opmerkingen
Wanneer het Menu besturingselement is gebonden aan een gegevensbron, gebruikt u de Value eigenschap om de waarde op te geven die moet worden gekoppeld aan de MenuItem.Value eigenschap van een MenuItem object. Deze waarde wordt gedeeld met alle menu-items waarop het MenuItemBinding object wordt toegepast. De opgegeven waarde wordt niet weergegeven in een menu-item en wordt gebruikt voor het opslaan van aanvullende gegevens over een menu-item waarop het MenuItemBinding object wordt toegepast, zoals gegevens die worden gebruikt voor het verwerken van terugvalgebeurtenissen.
Note
U kunt de waarde voor een afzonderlijke menu-item overschrijven door de Value eigenschap rechtstreeks in te stellen.
In plaats van deze eigenschap te gebruiken om dezelfde waarde op te geven voor elk menu-item, kunt u ook de Value eigenschap van een MenuItem object binden aan een veld van een gegevensbron door de ValueField eigenschap in te stellen. Wanneer deze wordt weergegeven, bevat de Value eigenschap van elk menu-item waarop het MenuItemBinding object wordt toegepast de bijbehorende waarde uit het veld.
Note
Als de Value eigenschappen ValueField beide zijn ingesteld, heeft de ValueField eigenschap voorrang.
De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.
