Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Classe MenuItemBindingCollection

.NET Framework 4.5

Outras versões

Representa uma coleção de objetos MenuItemBinding .

Hierarquia de herança

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

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

Sintaxe

C++

public sealed class MenuItemBindingCollection : StateManagedCollection

O tipo MenuItemBindingCollection expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Count	Obtém o número de elementos contidos no StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	Item	Obtém o MenuItemBinding o objeto no índice especificado da coleção.

Superior

Métodos

	Nome	Descrição
	Add	Acrescenta o especificado MenuItemBinding o objeto até o final da coleção.
	Clear	Remove todos os itens a partir do StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	Contains	Determina se o especificado MenuItemBinding objeto está na coleção.
	CopyTo(Array, Int32)	Copia os elementos da StateManagedCollection coleção para uma matriz, começando em um índice de matriz específico. (Herdado de StateManagedCollection.)
	CopyTo(MenuItemBinding[], Int32)	Copia todos os itens da MenuItemBindingCollection o objeto para uma matriz unidimensional compatível de MenuItemBinding objetos, iniciando no índice da matriz de destino especificado.
	Equals(Object)	Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
	GetEnumerator	Retorna um iterador que itera por meio do StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	GetHashCode	Serve como uma função hash para um tipo específico. (Herdado de Object.)
	GetType	Obtém o Type da instância atual. (Herdado de Object.)
	IndexOf	Determina o índice especificado MenuItemBinding objeto da coleção.
	Insert	Adiciona o especificado MenuItemBinding o objeto à coleção no local de índice especificado.
	Remove	Remove o especificado MenuItemBinding o objeto da coleção.
	RemoveAt	Remove o MenuItemBinding o objeto no local de índice especificado da coleção.
	SetDirty	Força a todo o StateManagedCollection coleção para ser serializado em estado de exibição. (Herdado de StateManagedCollection.)
	ToString	Retorna uma string que representa o objeto atual. (Herdado de Object.)

Superior

Implementações explícitas da interface

	Nome	Descrição
	ICollection.Count	Infraestrutura. Obtém o número de elementos contidos no StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	ICollection.IsSynchronized	Infraestrutura. Obtém um valor indicando se a StateManagedCollection coleção é sincronizada (segmento seguro). Esse método retorna false em todos os casos. (Herdado de StateManagedCollection.)
	ICollection.SyncRoot	Infraestrutura. Obtém um objeto que pode ser usado para sincronizar o acesso para o StateManagedCollection coleção. Esse método retorna null em todos os casos. (Herdado de StateManagedCollection.)
	IEnumerable.GetEnumerator	Infraestrutura. Retorna um iterador que itera por meio do StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	IList.Add	Adiciona um item para o StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	IList.Clear	Infraestrutura. Remove todos os itens a partir do StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	IList.Contains	Determina se a StateManagedCollection coleção contém um valor específico. (Herdado de StateManagedCollection.)
	IList.IndexOf	Determina o índice de um item especificado na StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	IList.Insert	Insere um item para o StateManagedCollection coleção no índice especificado. (Herdado de StateManagedCollection.)
	IList.IsFixedSize	Infraestrutura. Obtém um valor indicando se a StateManagedCollection coleção tem um tamanho fixo. Esse método retorna false em todos os casos. (Herdado de StateManagedCollection.)
	IList.IsReadOnly	Infraestrutura. Obtém um valor indicando se a StateManagedCollection coleção é somente leitura. (Herdado de StateManagedCollection.)
	IList.Item	Infraestrutura. Obtém o IStateManager o elemento no índice especificado. (Herdado de StateManagedCollection.)
	IList.Remove	Remove a primeira ocorrência do objeto especificado da StateManagedCollection coleção. (Herdado de StateManagedCollection.)
	IList.RemoveAt	Remove o IStateManager o elemento no índice especificado. (Herdado de StateManagedCollection.)
	IStateManager.IsTrackingViewState	Obtém um valor indicando se a StateManagedCollection coleção está salvando as alterações ao seu estado de exibição. (Herdado de StateManagedCollection.)
	IStateManager.LoadViewState	Restaura o estado de exibição salvo anteriormente da StateManagedCollection coleção e o IStateManager itens que ela contém. (Herdado de StateManagedCollection.)
	IStateManager.SaveViewState	Salva as alterações para o StateManagedCollection coleção e cada IStateManager objeto nele contido desde o momento a página foi remetido de volta para o servidor. (Herdado de StateManagedCollection.)
	IStateManager.TrackViewState	Faz com que o StateManagedCollection coleta e cada um a IStateManager objetos nele contidos para controlar as alterações ao seu estado de exibição para que eles podem ser mantidos em solicitações para a mesma página. (Herdado de StateManagedCollection.)

Superior

Comentários

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

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

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

Uso o Item indexador para recuperar diretamente a MenuItemBinding o objeto em um índice com base zero específico.
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 conteúdo da coleção em uma matriz.

Você pode gerenciar programaticamente um MenuItemBindingCollection o objeto, adicionando e removendo MenuItemBinding objetos. Para adicionar itens de menu para a 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.

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

Topic	Location
Demonstra Passo a passo: Controlando menus do ASP.NET de forma programática	dv_vwdcon
Demonstra Passo a passo: Exibir um menu em páginas da Web	dv_vwdcon
Demonstra Passo a passo: Controlando menus do ASP.NET por programação	Building ASP .NET Web Applications in Visual Studio
Passo a passo: controlando menus do ASP.NET por programação	dv_vwdcon
Passo a passo: exibindo um menu em páginas da Web	dv_vwdcon

Exemplos

O exemplo de código a seguir demonstra como preencher um MenuItemBindingCollection objeto declarativamente. Para este exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo em um arquivo denominado 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 de objeto por meio de programação. Para este exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo em um arquivo denominado 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>

Veja a seguir, dados de mapa do site de exemplo 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>

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Acesso thread-safe

Quaisquer membros estático (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.

Consulte também