Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe MenuItemBindingCollection

Representa uma coleção de objetos MenuItemBinding.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class MenuItemBindingCollection : StateManagedCollection

The MenuItemBindingCollection classe é usada para armazenar e gerenciar uma coleção de MenuItemBinding objetos na Menu controle. The Menu controle usa o MenuItemBindingCollection classe sistema autônomo o tipo de dados para seu DataBindings propriedade. The DataBindings propriedade é usada para armazenar qualquer ligações de item de menu definidas para o Menu controle.

ObservaçãoObservação:

A ordem em que MenuItemBinding objetos aparecem na coleção não tem efeito sobre como esses objetos são aplicados aos itens de menu em um Menu controle.

The MenuItemBindingCollection classe oferece suporte para várias maneiras de acessar os itens na coleção:

  • Use o Item Indexador recuperar diretamente a MenuItemBinding objeto em um índice específico baseado em zero.

  • Use o GetEnumerator método para criar um enumerador que pode ser usado para iterar na coleção.

  • Use o CopyTo método para copiar o Sumário da coleção em uma matriz.

Você pode gerenciar programaticamente um MenuItemBindingCollection objeto adicionando e removendo MenuItemBinding objetos. Para adicionar itens de menu à coleção, use o Add ou o Insert método. Para remover nós da coleção, use o Remove, o RemoveAt, ou o Clear método.

The MenuItemBindingCollection classe contém propriedades e métodos que permitem recuperar informações sobre a coleção em si. Para saber quantos itens estão na coleção, use o Count propriedade. Se você quiser determinar se a coleção contém um determinado MenuItemBinding objeto, use o Contains método. Para obter o índice de um MenuItemBinding objeto da coleção, use o IndexOf método.

O exemplo de código a seguir demonstra como popular um MenuItemBindingCollection objeto declarativamente. Para esse exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo em um arquivo chamado 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>



O exemplo de código a seguir demonstra como adicionar MenuItemBinding objetos para um MenuItemBindingCollection objeto programaticamente. Para esse exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo em um arquivo chamado 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>



A seguir é exemplo dados do MAP do site para os exemplos anteriores.

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

  • AspNetHostingPermission 

    Para operar em um ambiente hospedado.Exigem valor: LinkDemandValor de permissão: Minimal.

System.Object
  System.Web.UI.StateManagedCollection
    System.Web.UI.WebControls.MenuItemBindingCollection

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0
Mostrar: