MenuItemBinding.Value プロパティ
アセンブリ: System.Web (system.web.dll 内)

[LocalizableAttribute(true)] public: property String^ Value { String^ get (); void set (String^ value); }
MenuItemBinding オブジェクトが適用されるメニュー項目の補足データ。このデータは表示されません。既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

Menu コントロールをデータ ソースにバインドする場合、MenuItem オブジェクトの MenuItem.Value プロパティにバインドする値は、Value プロパティで指定します。この値は、MenuItemBinding オブジェクトが適用されるすべてのメニュー項目で共有されます。指定した値はメニュー項目には表示されず、MenuItemBinding オブジェクトが適用されるメニュー項目の補足データ (ポストバック イベントを処理するために使用するデータなど) を格納するために使用されます。
![]() |
---|
このプロパティを使用して各メニュー項目に同じ値を指定する代わりに、ValueField プロパティを設定して、MenuItem オブジェクトの Value プロパティをデータ ソースのフィールドにバインドすることもできます。レンダリング時、MenuItemBinding オブジェクトを適用した各メニュー項目の Value プロパティには、そのフィールドの対応する値が格納されます。
このプロパティを設定している場合、デザイナ ツールを使用して、その値を自動的にリソース ファイルに保存できます。詳細については、LocalizableAttribute、ASP.NET のグローバリゼーションおよびローカリゼーション の各トピックを参照してください。

Value プロパティを使用して、メニュー項目に関連付けられた非表示の値を指定する方法を次のコード例に示します。この値は、MenuItemBinding オブジェクトが適用される各メニュー項目で使用されます。この例を正常に動作させるには、以下のサンプル XML データを、Menu.xml という名前のファイルにコピーする必要があります。
<%@ page language="VB" %> <html> <body> <form 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="C#" %> <html> <body> <form 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>
前の例のサンプル サイト マップ データを次のコードに示します。
<MapHomeNode ImageUrl="~\Images\Home.gif"
<MapNode ImageUrl="~\Images\Music.gif"
<MapNode ImageUrl="~\Images\Classical.gif"
Description="Classical Section"
<MapNode ImageUrl="~\Images\Rock.gif"
<MapNode ImageUrl="~\Images\Jazz.gif"
</MapNode>
<MapNode ImageUrl="~\Images\Movies.gif"
<MapNode ImageUrl="~\Images\Action.gif"
<MapNode ImageUrl="~\Images\Drama.gif"
<MapNode ImageUrl="~\Images\Musical.gif"
</MapNode>
</MapHomeNode>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


MenuItemBinding クラス
MenuItemBinding メンバ
System.Web.UI.WebControls 名前空間
Menu クラス
MenuItem クラス
MenuItemBindingCollection
XmlDataSource
Menu.DataBindings プロパティ
MenuItemBinding.DataMember プロパティ
MenuItemBinding.Depth プロパティ
MenuItemBinding.FormatString プロパティ
MenuItemBinding.ImageUrl プロパティ
MenuItemBinding.ImageUrlField プロパティ
MenuItemBinding.NavigateUrl プロパティ
MenuItemBinding.NavigateUrlField プロパティ
MenuItemBinding.Target プロパティ
MenuItemBinding.Text プロパティ
MenuItemBinding.TextField プロパティ
MenuItemBinding.ToolTip プロパティ
MenuItemBinding.ToolTipField プロパティ
MenuItem.Value プロパティ
ValueField
- MenuItemBinding.Value プロパティのページへのリンク