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>

下面的代码示例演示如何以编程方式将对象添加到MenuItemBinding 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">
<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 类

定义

示例

注解

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

其他资源