Proprietà MenuItemBinding.ValueField
Aggiornamento: novembre 2007
Ottiene o imposta il nome del campo dall'origine dati per l'associazione alla proprietà Value di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding.
Assembly: System.Web (in System.Web.dll)
[TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")] public string ValueField { get; set; }
/** @property */
/** @attribute TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public String get_ValueField()
/** @property */
/** @attribute TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public void set_ValueField(String value)
public function get ValueField () : String public function set ValueField (value : String)
Valore proprietà
Tipo: System.StringNome del campo da associare alla proprietà Value di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.
Quando il controllo Menu è associato a un'origine dati, utilizzare la proprietà ValueField per specificare il nome del campo da associare alla proprietà Value di un oggetto MenuItem. Quando si esegue il rendering, la proprietà Value di ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding contiene il valore corrispondente dal campo. Il valore specificato non viene visualizzato in una voce di menu e viene utilizzato per memorizzare dati aggiuntivi relativi a una voce di menu a cui è applicato l'oggetto MenuItemBinding, ad esempio i dati utilizzati per la gestione degli eventi di postback.
 Nota: |
|---|
È possibile eseguire l'override di un valore per ciascuna voce di menu impostandone direttamente la proprietà Value. |
Se l'origine dati contiene più tabelle o attributi, è necessario innanzitutto stabilire i criteri di associazione impostando la proprietà Depth, la proprietà DataMember o entrambe.
Anziché utilizzare questa proprietà per associare la proprietà Value di un oggetto MenuItem a un campo, è anche possibile associarla a un valore statico tramite l'impostazione della proprietà MenuItemBinding.Value. In questo modo è possibile specificare lo stesso valore per ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding.
| Nota: |
|---|
Se le proprietà Value e ValueField sono entrambe impostate, la proprietà ValueField ha la precedenza. |
Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà ValueField per specificare il nome del campo da associare alla proprietà Value di una voce di menu. Perché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio che seguono in un file denominato 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" formatstring="({0})" textfield="Title" valuefield="Description" imageurlfield="ImageUrl" tooltipfield="ToolTip" target="_self" /> <asp:menuitembinding datamember="MapNode" depth="1" formatstring="[{0}]" textfield="Title" valuefield="Description" imageurlfield="ImageUrl" tooltipfield="ToolTip" target="_blank"/> <asp:menuitembinding datamember="MapNode" depth="2" formatstring="<{0}>" textfield="Title" valuefield="Description" imageurlfield="ImageUrl" tooltipfield="ToolTip" target="_blank"/> </DataBindings> </asp:menu> <asp:xmldatasource id="MenuSource" datafile="Menu.xml" runat="server"/> </form> </body> </html>
Nel codice riportato di seguito sono riportati i dati della mappa del sito di esempio per l'esempio precedente.
<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>
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
