MenuItemBindingCollection 類別

參考

定義

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

組件:: System.Web.dll

重要

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

表示 MenuItemBinding 物件的集合。

public ref class MenuItemBindingCollection sealed : System::Web::UI::StateManagedCollection

public sealed class MenuItemBindingCollection : System.Web.UI.StateManagedCollection

type MenuItemBindingCollection = class
    inherit StateManagedCollection

Public NotInheritable Class MenuItemBindingCollection
Inherits StateManagedCollection

繼承: Object

StateManagedCollection
MenuItemBindingCollection

範例

下列程式碼範例示範如何以宣告方式填入 MenuItemBindingCollection 物件。若要讓此範例正常運作，您必須將下面的範例 XML 資料複製到名為 Map.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>Menu DataBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBindings Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">
        
       <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode" 
            depth="0"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            textfield="title" 
            navigateurlfield="url"/>
        </DataBindings>
        
      </asp:menu>
      
      <asp:XmlDataSource id="MenuSource"
        datafile="Map.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>Menu DataBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBindings Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
          <asp:menuitembinding datamember="MapHomeNode" 
            depth="0"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            textfield="title" 
            navigateurlfield="url"/>
        </DataBindings>
        
      </asp:menu>
      
      <asp:XmlDataSource id="MenuSource"
        datafile="Map.xml"
        runat="server"/>        

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

下列程式碼範例示範如何以程式設計方式將物件 MenuItemBindingCollection 加入 MenuItemBinding 物件。若要讓此範例正常運作，您必須將下面的範例 XML 資料複製到名為 Map.xml 的檔案。


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {
    if(!IsPostBack)
    {
      // Create the menu item bindings for the Menu control.
      MenuItemBinding binding;
      
      binding = CreateMenuItemBinding("MapHomeNode", 0, "title", "url");
      NavigationMenu.DataBindings.Add(binding);

      binding = CreateMenuItemBinding("MapNode", 1, "title", "url");
      NavigationMenu.DataBindings.Add(binding);

      binding = CreateMenuItemBinding("MapNode", 2, "title", "url");
      NavigationMenu.DataBindings.Add(binding);
    }
  }

  // This is a helper method to create a MenuItemBinding 
  // object from the specified parameters.
  MenuItemBinding CreateMenuItemBinding(String dataMember, int depth, String textField, String navigateUrlField)
  {
    // Create a new MenuItemBinding object.
    MenuItemBinding binding = new MenuItemBinding();

    // Set the properties of the MenuItemBinding object.
    binding.DataMember = dataMember;
    binding.Depth = depth;
    binding.TextField = textField;
    binding.NavigateUrlField = navigateUrlField;

    return binding;
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">        
      </asp:menu>
      
      <asp:xmldatasource id="MenuSource"
        datafile="Map.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">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
 
    If Not IsPostBack Then
    
      ' Create the menu item bindings for the Menu control.
      Dim binding As MenuItemBinding
      
      binding = CreateMenuItemBinding("MapHomeNode", 0, "title", "url")
      NavigationMenu.DataBindings.Add(binding)

      binding = CreateMenuItemBinding("MapNode", 1, "title", "url")
      NavigationMenu.DataBindings.Add(binding)

      binding = CreateMenuItemBinding("MapNode", 2, "title", "url")
      NavigationMenu.DataBindings.Add(binding)
   
    End If
    
  End Sub

  ' This is a helper method to create a MenuItemBinding 
  ' object from the specified parameters.
  Function CreateMenuItemBinding(ByVal dataMember As String, ByVal depth As Integer, ByVal textField As String, ByVal navigateUrlField As String) As MenuItemBinding
  
    ' Create a new MenuItemBinding object.
    Dim binding As New MenuItemBinding()

    ' Set the properties of the MenuItemBinding object.
    binding.DataMember = dataMember
    binding.Depth = depth
    binding.TextField = textField
    binding.NavigateUrlField = navigateUrlField

    Return binding
    
  End Function
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">        
      </asp:menu>
      
      <asp:xmldatasource id="MenuSource"
        datafile="Map.xml"
        runat="server"/>        

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

以下是先前範例的範例網站地圖資料。

<MapHomeNode url="~\Home.aspx"

title="Home"

description="Home">

<MapNode url="~\Music.aspx"

title="Music"

description="Music">

<MapNode url="~\Classical.aspx"

title="Classical"

description="Classical"/>

<MapNode url="~\Rock.aspx"

title="Rock"

description="Rock"/>

<MapNode url="~\Jazz.aspx"

title="Jazz"

description="Jazz"/>

</MapNode>

<MapNode url="~\Movies.aspx"

title="Movies"

description="Movies">

<MapNode url="~\Action.aspx"

title="Action"

description="Action"/>

<MapNode url="~\Drama.aspx"

title="Drama"

description="Drama"/>

<MapNode url="~\Musical.aspx"

title="Musical"

description="Musical"/>

</MapNode>

</MapHomeNode>

備註

類別 MenuItemBindingCollection 是用來儲存和管理控制項中的 Menu 物件集合 MenuItemBinding 。控制項 Menu 使用 MenuItemBindingCollection 類別做為其屬性的 DataBindings 資料類型。屬性 DataBindings 是用來儲存為 Menu 控制項定義的任何功能表項目系結。

注意

物件出現在集合中的順序 MenuItemBinding 不會影響這些物件如何套用至控制項中的 Menu 功能表項目。

類別 MenuItemBindingCollection 支援數種方式來存取集合中的專案：

Item[]使用索引子直接擷取 MenuItemBinding 特定以零起始之索引處的物件。
GetEnumerator使用方法來建立可用來逐一查看集合的列舉值。
CopyTo使用方法，將集合的內容複寫到陣列中。

您可以藉由新增和移除 MenuItemBinding 物件，以程式設計方式管理 MenuItemBindingCollection 物件。若要將功能表項目新增至集合，請使用 Add 或 Insert 方法。若要從集合中移除節點，請使用 Remove 、 RemoveAt 或 Clear 方法。

類別 MenuItemBindingCollection 包含屬性和方法，可讓您擷取集合本身的相關資訊。若要瞭解集合中的專案數目，請使用 Count 屬性。如果您想要判斷集合是否包含特定 MenuItemBinding 物件，請使用 Contains 方法。若要取得集合中物件的索引 MenuItemBinding ，請使用 IndexOf 方法。

屬性

Count	取得 StateManagedCollection 集合中所包含的項目數。 (繼承來源 StateManagedCollection)
Item[Int32]	取得集合中位於指定索引處的 MenuItemBinding 物件。

方法

Add(MenuItemBinding)	將指定的 MenuItemBinding 物件附加到集合的結尾。
Clear()	將所有項目從 StateManagedCollection 集合中移除。 (繼承來源 StateManagedCollection)
Contains(MenuItemBinding)	判斷指定的 MenuItemBinding 物件是否在集合中。
CopyTo(Array, Int32)	從特定的陣列索引開始，將 StateManagedCollection 集合的項目複製到陣列。 (繼承來源 StateManagedCollection)
CopyTo(MenuItemBinding[], Int32)	從目標陣列中的指定索引開始，從 MenuItemBindingCollection 物件中，將所有項目複製至相容的一維陣列 MenuItemBinding 物件。
CreateKnownType(Int32)	在衍生類別中覆寫時，建立實作 IStateManager 之類別的執行個體。根據 GetKnownTypes() 方法所傳回之集合指定的成員，建立物件的類型。 (繼承來源 StateManagedCollection)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回逐一查看 StateManagedCollection 集合的列舉值。 (繼承來源 StateManagedCollection)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetKnownTypes()	在衍生類別中覆寫時，取得 StateManagedCollection 集合可以包含之 IStateManager 類型的陣列。 (繼承來源 StateManagedCollection)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IndexOf(MenuItemBinding)	判斷集合中指定之 MenuItemBinding 物件的索引。
Insert(Int32, MenuItemBinding)	在指定索引位置將指定的 MenuItemBinding 物件加入集合。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnClear()	在衍生類別中覆寫時，在 Clear() 方法移除集合的所有項目之前，執行額外工作。 (繼承來源 StateManagedCollection)
OnClearComplete()	在衍生類別中覆寫時，在 Clear() 方法完成移除集合的所有項目之後，執行額外工作。 (繼承來源 StateManagedCollection)
OnInsert(Int32, Object)	在衍生類別中覆寫時，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法將項目加入集合之前，執行額外工作。 (繼承來源 StateManagedCollection)
OnInsertComplete(Int32, Object)	在衍生類別中覆寫時，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法將項目加入集合之後，執行額外工作。 (繼承來源 StateManagedCollection)
OnRemove(Int32, Object)	在衍生類別中覆寫時，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法從集合中移除指定的項目之前，執行額外工作。 (繼承來源 StateManagedCollection)
OnRemoveComplete(Int32, Object)	在衍生類別中覆寫時，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法從集合中移除指定的項目之後，執行額外工作。 (繼承來源 StateManagedCollection)
OnValidate(Object)	在衍生類別中覆寫時，驗證 StateManagedCollection 集合的項目。 (繼承來源 StateManagedCollection)
Remove(MenuItemBinding)	從集合中移除指定的 MenuItemBinding 物件。
RemoveAt(Int32)	從集合中移除指定索引位置的 MenuItemBinding 物件。
SetDirty()	強制整個 StateManagedCollection 集合序列化至檢視狀態。 (繼承來源 StateManagedCollection)
SetDirtyObject(Object)	在衍生類別中覆寫時，指示集合中所包含的 `object`，將其完整狀態 (而不只是變更資訊) 記錄至檢視狀態。 (繼承來源 StateManagedCollection)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

ICollection.Count	取得 StateManagedCollection 集合中所包含的項目數。 (繼承來源 StateManagedCollection)
ICollection.IsSynchronized	取得值，表示 StateManagedCollection 集合是否為同步 (安全執行緒)。在所有情況下，這個方法都會傳回 `false`。 (繼承來源 StateManagedCollection)
ICollection.SyncRoot	取得物件，可用來同步處理對 StateManagedCollection 集合的存取。在所有情況下，這個方法都會傳回 `null`。 (繼承來源 StateManagedCollection)
IEnumerable.GetEnumerator()	傳回逐一查看 StateManagedCollection 集合的列舉值。 (繼承來源 StateManagedCollection)
IList.Add(Object)	將項目加入 StateManagedCollection 集合。 (繼承來源 StateManagedCollection)
IList.Clear()	將所有項目從 StateManagedCollection 集合中移除。 (繼承來源 StateManagedCollection)
IList.Contains(Object)	判斷 StateManagedCollection 集合是否包含特定值。 (繼承來源 StateManagedCollection)
IList.IndexOf(Object)	判斷 StateManagedCollection 集合中指定之項目的索引。 (繼承來源 StateManagedCollection)
IList.Insert(Int32, Object)	將項目插入位於指定索引處的 StateManagedCollection 集合中。 (繼承來源 StateManagedCollection)
IList.IsFixedSize	取得值，表示 StateManagedCollection 集合是否具有固定大小。在所有情況下，這個方法都會傳回 `false`。 (繼承來源 StateManagedCollection)
IList.IsReadOnly	取得值，表示 StateManagedCollection 集合是否為唯讀。 (繼承來源 StateManagedCollection)
IList.Item[Int32]	取得指定索引處的 IStateManager 項目。 (繼承來源 StateManagedCollection)
IList.Remove(Object)	從 StateManagedCollection 集合中移除指定物件的第一個符合項目。 (繼承來源 StateManagedCollection)
IList.RemoveAt(Int32)	移除指定索引處的 IStateManager 項目。 (繼承來源 StateManagedCollection)
IStateManager.IsTrackingViewState	取得值，表示 StateManagedCollection 集合是否正在儲存變更至檢視狀態。 (繼承來源 StateManagedCollection)
IStateManager.LoadViewState(Object)	還原先前儲存之 StateManagedCollection 集合和內含 IStateManager 項目的檢視狀態。 (繼承來源 StateManagedCollection)
IStateManager.SaveViewState()	儲存自頁面回傳至伺服器以來 StateManagedCollection 集合和每個內含 IStateManager 物件的變更。 (繼承來源 StateManagedCollection)
IStateManager.TrackViewState()	使得 StateManagedCollection 集合和每個內含 IStateManager 物件追蹤其檢視狀態的變更，以便跨相同頁面要求保存這些變更。 (繼承來源 StateManagedCollection)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。

適用於

MenuItemBindingCollection 類別

定義

範例

備註

屬性

方法

明確介面實作

擴充方法

適用於

另請參閱

其他資源