MenuItemBinding.DataMember プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MenuItemBinding.DataMember プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

メニュー項目にバインドするデータメンバを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property DataMember As
 String

Visual Basic (使用法)

Dim instance As MenuItemBinding
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get;
 set; }

C++

public:
property String^ DataMember {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DataMember ()

/** @property */
public void set_DataMember (String value)

JScript

public function get DataMember
 () : String

public function set DataMember
 (value : String)

プロパティ値
メニュー項目にバインドするデータメンバ。既定値は空の文字列 ("") です。この値は、このプロパティが設定されていないことを示します。

解説

MenuItemBinding オブジェクトを作成する場合、バインディング基準を指定する必要があります。基準は、データ項目をメニュー項目にバインドするタイミングを示します。Depth プロパティと DataMember プロパティのいずれか、または両方を指定できます。

データソースに複数の要素またはテーブルが含まれる場合は、DataMember プロパティを使用して、メニュー項目にバインドする要素またはテーブルを指定します。データメンバは、基になるデータソースのデータ項目の型を指定します。ただし、データソースによっては異なる情報を表している場合があります。階層データソースの各データ項目 (System.Web.UI.IHierarchyData オブジェクトで表される) は、データ項目の型を指定する IHierarchyData.Type プロパティを公開します。たとえば、XML 要素のデータメンバは、要素名を指定します。次の MenuItemBinding 宣言は、階層構造の場所に無関係に、XmlDataSource コントロールの <Book> 要素をメニュー内のすべてのメニュー項目にバインドします。

<asp:MenuItemBinding DataMember="Book" TextField="Title" ValueField= "ISBN">

深さとデータメンバの両方を指定するメニュー項目バインディングの作成が必要になる場合があります。このバインディングは、データソースに異なるレベルで同じデータメンバ値を持つ項目が含まれている場合によく使用されます。たとえば、1 つの XML ファイル内の異なるレベルに表示される <Item> 要素を指定できます。メニューの深さが異なる同一のデータメンバに適用されるメニュー項目バインディングの指定方法を次の MenuItemBinding 宣言に示します。

<asp:MenuItemBinding DataMember="Item" Depth="1" TextField="Title">

<asp:MenuItemBinding DataMember="Item" Depth="2" TextField="ISBN">

深さやデータメンバを指定せずにメニュー項目バインディングを定義した場合、メニュー項目バインディングは、メニュー内のすべてのメニュー項目に適用されます。これは、通常、すべてのデータ項目に同じプロパティが存在し、メニューの深さに無関係にまったく同じ表示にする必要がある場合に使用されます。

バインディング基準が確立されたら、バインド可能な MenuItem オブジェクトのプロパティを値にバインドできます。データ項目のフィールドまたは静的な値にバインドできます。MenuItemBinding オブジェクトに静的な値がバインドされた場合、そのオブジェクトの適用先となるすべての MenuItem オブジェクトは、同じ値を共有します。フィールドにバインドされるプロパティには、データソースのフィールドの値が格納されています。

競合する MenuItemBinding オブジェクトが定義されている場合、Menu コントロールは次の優先順位でメニュー項目のバインディングを適用します。

深さとデータメンバの両方を定義し照合する MenuItemBinding オブジェクト。
データメンバだけを定義し照合する MenuItemBinding オブジェクト。
深さだけを定義し照合する MenuItemBinding オブジェクト。
深さもデータメンバも定義しない MenuItemBinding オブジェクト。この種のメニュー項目バインディングは、メニュー内のすべてのメニュー項目に適用されます。
データソース内に一致するものがない MenuItemBinding オブジェクト。この場合、データ項目の ToString() メソッドによって返される値は、MenuItemBinding オブジェクトが適用されるメニュー項目の Text プロパティと Value プロパティにバインドされます。

使用例

DataMember プロパティを使用して、Menu コントロール内のメニュー項目にバインドする XML 要素を指定する方法を次のコード例に示します。この例を正常に動作させるには、以下のサンプル XML データを、MenuDataMember.xml という名前のファイルにコピーする必要があります。

Visual Basic

<%@ page language="VB" %>

<html>
  <body>
    <form runat="server">

      <h3>MenuItemBinding DataMember Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapNodeHome"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNodeCategory"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNodeSection"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="MenuDataMember.xml"
        runat="server"/> 

    </form>
  </body>
</html>

<%@ page language="C#" %>

<html>
  <body>
    <form runat="server">

      <h3>MenuItemBinding DataMember Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapNodeHome"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNodeCategory"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNodeSection"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="MenuDataMember.xml"
        runat="server"/> 

    </form>
  </body>
</html>

前の例のサンプルサイトマップデータを次のコードに示します。

<MapNodeHome ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNodeCategory ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNodeSection ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNodeSection ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNodeSection ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNodeCategory>

<MapNodeCategory ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNodeSection ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNodeSection ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNodeSection ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNodeCategory>

</MapNodeHome>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MenuItemBinding クラス
MenuItemBinding メンバ
System.Web.UI.WebControls 名前空間
Menu クラス
MenuItem クラス
MenuItemBindingCollection
Menu.DataBindings プロパティ
Depth
MenuItem.Depth プロパティ

>> 「MenuItemBinding.DataMember プロパティ」を含む用語の索引
MenuItemBinding.DataMember プロパティのページへのリンク

MenuItemBinding.DataMember プロパティとは？わかりやすく解説

MenuItemBinding.DataMember プロパティ

「MenuItemBinding.DataMember プロパティ」の関連用語


	© 2025 Microsoft.All rights reserved.

MenuItemBinding.DataMember プロパティとは？ わかりやすく解説

MenuItemBinding.DataMember プロパティ

急上昇のことば

「MenuItemBinding.DataMember プロパティ」の関連用語

MenuItemBinding.DataMember プロパティとは？わかりやすく解説