MenuItemBinding.Value Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines nicht angezeigten Werts, der zum Speichern zusätzlicher Daten zu einem Menüelement verwendet wird, auf das das MenuItemBinding Objekt angewendet wird, z. B. Daten zum Behandeln von Postbackereignissen.
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 StringEigenschaftswert
Zusätzliche Daten zu einem Menüelement, auf das die MenuItemBinding Anwendung angewendet wird; diese Daten werden nicht angezeigt. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Value Eigenschaft verwendet wird, um einen nicht angezeigten Wert anzugeben, der einem Menüelement zugeordnet ist. Dieser Wert wird in jedem Menüelement verwendet, auf das das MenuItemBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispieldaten in eine Datei mit dem Namen Menu.xmlkopieren.
<%@ 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>
Der folgende Code ist Beispielwebsitezuordnungsdaten für das vorherige Beispiel.
<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>
Hinweise
Wenn das Menu Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die Value Eigenschaft, um den Wert anzugeben, der an die MenuItem.Value Eigenschaft eines MenuItem Objekts gebunden werden soll. Dieser Wert wird für alle Menüelemente freigegeben, auf die das MenuItemBinding Objekt angewendet wird. Der angegebene Wert wird nicht in einem Menüelement angezeigt und wird verwendet, um zusätzliche Daten zu einem Menüelement zu speichern, auf das das Objekt angewendet wird, z. B. Daten, die für die MenuItemBinding Behandlung von Postbackereignissen verwendet werden.
Hinweis
Sie können den Wert für ein einzelnes Menüelement überschreiben, indem Sie dessen Value Eigenschaft direkt festlegen.
Anstatt diese Eigenschaft zum Angeben desselben Werts für jedes Menüelement zu verwenden, können Sie auch die Value Eigenschaft eines MenuItem Objekts an ein Feld einer Datenquelle binden, indem Sie die ValueField Eigenschaft festlegen. Beim Rendern enthält die Value Eigenschaft jedes Menüelements, auf das das MenuItemBinding Objekt angewendet wird, den entsprechenden Wert aus dem Feld.
Hinweis
Wenn beide Value Eigenschaften ValueField festgelegt sind, hat die ValueField Eigenschaft Vorrang.
Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".
