MenuItemBinding 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在 Menu 控制項中，定義資料項目及其繫結功能表項目之間的關係。此類別無法獲得繼承。

public ref class MenuItemBinding sealed : ICloneable, System::Web::UI::IDataSourceViewSchemaAccessor, System::Web::UI::IStateManager

public sealed class MenuItemBinding : ICloneable, System.Web.UI.IDataSourceViewSchemaAccessor, System.Web.UI.IStateManager

type MenuItemBinding = class
    interface IStateManager
    interface ICloneable
    interface IDataSourceViewSchemaAccessor

Public NotInheritable Class MenuItemBinding
Implements ICloneable, IDataSourceViewSchemaAccessor, IStateManager

繼承: Object
MenuItemBinding

實作: ICloneable IDataSourceViewSchemaAccessor IStateManager

範例

下列程式碼範例示範如何使用 MenuItemBinding 物件來定義控制項欄位 XmlDataSource 與控制項中 Menu 功能表項目之間的關聯性。若要讓此範例正常運作，您必須將下面的範例 XML 資料複製到名為 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>


<%@ 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"
            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>

下列程式碼是上述範例的範例網站地圖資料。

<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>

備註

Menu當控制項系結至資料來源時，每個資料項目都包含多個欄位 (，例如具有數個屬性的 XML 元素) ，如果沒有定義功能表項目系結，功能表項目預設會顯示資料項目方法所 ToString() 傳回的值。在 XML 元素的情況下，功能表項目會顯示專案名稱，其中顯示功能表的基礎結構，但不是非常有用的。您可以藉由指定功能表項目系結，將功能表項目的屬性系結至特定欄位。 MenuItemBinding物件會定義每個資料項目與其系結至之功能表項目之間的關聯性。

注意

Menu當控制項系結至 SiteMapDataSource 控制項時，功能表項目系結不會有任何作用。系結會使用網站地圖提供者自動執行。

控制項 Menu 會將物件儲存在屬性中 DataBindings ，並將系 MenuItemBinding 結套用至資料來源，以建立功能表階層與資料來源階層之間的一對一關聯性。針對資料來源中的每個資料項目， Menu 控制項會嘗試將資料項目與 MenuItemBinding 物件相符，以建立對應的 MenuItem 物件。

建立 MenuItemBinding 物件時，您必須指定系結的準則。準則會指出資料項目何時應該系結至功能表項目。您可以指定 Depth 、 DataMember 或兩者。

功能表項目深度會指定系結的功能表層級。例如，下列 MenuItemBinding 宣告會將資料來源的 Name 和 ID 欄位分別系結至 Text 深度為 0 的所有節點的和 Value 屬性：

<asp:MenuItemBinding Depth="0" TextField="Name" ValueField="ID">

資料成員會指定基礎資料來源中資料項目的類型，但可以根據資料來源來表示不同的資訊。階層式資料來源中的每個資料項目 (由 IHierarchyData 物件表示，) 公開 Type 屬性，這會指定資料項目的類型。例如，XML 元素的資料成員會指定專案的名稱。當資料來源包含多個資料項目類型時，資料成員會指定要使用的資料類型。下列 MenuItemBinding 宣告會將 <Book> 控制項的專案 XmlDataSource 系結至功能表中的所有功能表項目，而不論階層中的位置為何：

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

有時候您可能需要建立功能表項目系結，以指定深度和資料成員。當資料來源包含具有相同資料成員值的不同層級的專案時，通常會使用這個值。例如，您可以有 <Item> 出現在 XML 檔案內不同層級的專案。下列 MenuItemBinding 宣告示範如何指定套用至不同功能表深度相同資料成員的功能表項目系結：

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

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

如果沒有深度和資料成員定義功能表項目系結，功能表項目系結就會套用至功能表內的所有功能表項目。不論功能表深度為何，所有資料項目都有相同的屬性，而且應該以相同方式顯示時，通常會使用此方式。

建立系結準則之後，您就可以系結可系結至值的物件屬性 MenuItem 。您可以系結至資料項目的欄位或靜態值。系結至靜態值時，套用物件的所有 MenuItem 物件 MenuItemBinding 都會共用相同的值。系結至欄位的屬性包含資料來源中對應欄位的值。

注意

您可以直接設定對應的屬性，選擇性地覆寫物件中的 MenuItem 系結屬性。

下表列出類別的屬性 MenuItemBinding ，可讓您將物件的屬性 MenuItem 系結至資料項目的欄位。

屬性	描述
ImageUrlField	要系結至 ImageUrl 物件屬性的 MenuItem 欄位。
NavigateUrlField	要系結至 NavigateUrl 物件屬性的 MenuItem 欄位。
TextField	要系結至 Text 物件屬性的 MenuItem 欄位。
ToolTipField	要系結至 ToolTip 物件屬性的 MenuItem 欄位。
ValueField	要系結至 Value 物件屬性的 MenuItem 欄位。

下表列出類別的屬性 MenuItemBinding ，可讓您將物件的屬性 MenuItem 系結至靜態值。

屬性	描述
ImageUrl	要系結至 ImageUrl 物件的屬性的 MenuItem 靜態值。
NavigateUrl	要系結至 NavigateUrl 物件的屬性的 MenuItem 靜態值。
Target	要系結至 Target 物件的屬性的 MenuItem 靜態值。
Text	要系結至 Text 物件的屬性的 MenuItem 靜態值。
ToolTip	要系結至 ToolTip 物件的屬性的 MenuItem 靜態值。
Value	要系結至 Value 物件的屬性的 MenuItem 靜態值。

如果定義衝突 MenuItemBinding 的物件， Menu 控制項會以下列優先順序套用功能表項目系結：

MenuItemBinding定義及比對深度和資料成員的物件。
MenuItemBinding只定義及符合資料成員的物件。
MenuItemBinding定義和只符合深度的物件。
MenuItemBinding定義深度和資料成員的物件。 (此類型的功能表項目系結會套用至 menu.)
MenuItemBinding資料來源中沒有相符專案的物件。在此情況下，資料項目的方法所傳 ToString() 回的值接著會系結至 Text 套用物件之功能表項目 MenuItemBinding 的和 Value 屬性。

類別 MenuItemBinding 也可讓您藉由設定 FormatString 屬性，格式化功能表項目中顯示的文字。

建構函式

MenuItemBinding()

初始化 MenuItemBinding 類別的新執行個體。

屬性

DataMember	取得或設定要繫結至功能表項目的資料成員。
Depth	取得或設定套用 MenuItemBinding 物件的功能表深度。
Enabled	取得或設定值，指出套用 MenuItemBinding 物件的功能表項目是否已啟用，讓項目能夠顯示快顯影像及任何子功能表項目。
EnabledField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 Enabled 物件之 MenuItem 物件的 MenuItemBinding 物件。
FormatString	取得或設定字串，指定套用 MenuItemBinding 物件之功能表項目文字的顯示格式。
ImageUrl	取得或設定影像的 URL，該影像會顯示在套用 MenuItemBinding 物件之功能表項目的文字旁。
ImageUrlField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 ImageUrl 物件之 MenuItem 物件的 MenuItemBinding 物件。
NavigateUrl	取得或設定在按一下套用 MenuItemBinding 物件的功能表項目時連結至的 URL。
NavigateUrlField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 NavigateUrl 物件之 MenuItem 物件的 MenuItemBinding 物件。
PopOutImageUrl	取得或設定影像的 URL，該影像表示套用 MenuItemBinding 物件的功能表項目是否有動態 (Dynamic) 子功能表。
PopOutImageUrlField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 PopOutImageUrl 物件之 MenuItem 物件的 MenuItemBinding 物件。
Selectable	取得或設定值，指出套用 MenuItemBinding 物件的功能表項目是否可選取，或是否為「可點選」。
SelectableField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 Selectable 物件之 MenuItem 物件的 MenuItemBinding 物件。
SeparatorImageUrl	取得或設定影像的 URL，對於套用 MenuItemBinding 物件的功能表項目，該影像會顯示於功能表項目的文字下方 (以將其本身與其他功能表項目加以分隔)。
SeparatorImageUrlField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 SeparatorImageUrl 物件之 MenuItem 物件的 MenuItemBinding 物件。
Target	取得或設定目標視窗或框架，在其中顯示與套用 MenuItemBinding 物件之功能表項目相關聯的 Web 網頁內容。
TargetField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 Target 物件之 MenuItem 物件的 MenuItemBinding 物件。
Text	取得或設定為套用 MenuItemBinding 物件之功能表項目所顯示的文字。
TextField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 Text 物件之 MenuItem 物件的 MenuItemBinding 物件。
ToolTip	取得或設定套用 MenuItemBinding 物件之功能表項目的工具提示文字。
ToolTipField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 ToolTip 物件之 MenuItem 物件的 MenuItemBinding 物件。
Value	取得或設定非顯示值，這個值是用來儲存與套用 MenuItemBinding 物件之功能表項目相關的任何其他資料，例如，用於處理回傳事件的資料。
ValueField	取得或設定欄位來自資料來源之欄位的名稱，以繫結至套用 Value 物件之 MenuItem 物件的 MenuItemBinding 物件。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。

明確介面實作

ICloneable.Clone()	建立 MenuItemBinding 物件的複本。
IDataSourceViewSchemaAccessor.DataSourceViewSchema	如需這個成員的說明，請參閱 DataSourceViewSchema。
IStateManager.IsTrackingViewState	取得值，指出 MenuItemBinding 物件是否正在儲存變更至它的檢視狀態。
IStateManager.LoadViewState(Object)	載入節點先前儲存的檢視狀態。
IStateManager.SaveViewState()	將檢視狀態變更儲存至 Object。
IStateManager.TrackViewState()	指示 MenuItemBinding 物件追蹤其檢視狀態的變更。

適用於

MenuItemBinding 類別

定義

範例

備註

建構函式

屬性

方法

明確介面實作

適用於

另請參閱

其他資源