Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar
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

Propriedade Menu.DataBindings

Obtém uma coleção de MenuItemBinding objetos que definem a relação entre um item de dados e o item de menu, ele está ligado.

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

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public MenuItemBindingCollection DataBindings { get; }

Valor de propriedade

Tipo: System.Web.UI.WebControls.MenuItemBindingCollection
A MenuItemBindingCollection que representa a relação entre um item de dados e o item de menu, ele está ligado.

O DataBindings contém a coleção MenuItemBinding objetos que definem a relação entre um item de dados e o item de menu, ele está ligado. Quando a vinculação a uma fonte de dados, onde cada item de dados contém várias propriedades (como um elemento XML com vários atributos), um item de menu exibe o valor retornado pela ToString() o método do item de dados por padrão. No caso de um elemento XML, o item de menu exibe o nome de elemento, que mostra a estrutura subjacente da árvore, mas não é muito útil caso contrário. Você pode vincular um item de menu a uma propriedade de item de dados específica, especificando ligações de item de menu.

Ao definir a relação entre um item de dados e um item de menu, você deve especificar critérios para ligação e a propriedade de um item de dados vincular a. Os critérios indicam quando um item de dados deve ser vinculado a um item de menu. Os critérios podem ser especificados com uma profundidade, um membro de dados ou ambos. A profundidade Especifica o nível de menu que obtém vinculado. Por exemplo, se você especificar uma profundidade de 0, todos os itens de menu na estrutura de árvore no nível 0 são vinculados usando a ligação do item de menu. Um membro de dados especifica o tipo de item de dados na fonte de dados subjacente, mas pode representar informações diferentes dependendo da fonte de dados. Por exemplo, o membro de dados para um elemento XML Especifica o nome do elemento.

Se vários MenuItemBinding objetos são definidos que entram em conflito com os outros, o Menu controle aplica as ligações de item de menu na seguinte ordem de precedência:

  1. O MenuItemBinding o objeto que define uma profundidade e um membro de dados.

  2. O MenuItemBinding objeto que define apenas a profundidade.

  3. O MenuItemBinding objeto que define o membro de dados.

  4. O MenuItemBinding objeto que define a profundidade nem o membro de dados.

Depois que os critérios de ligação são estabelecidos, você pode vincular uma propriedade de um MenuItem o objeto que pode ser vinculado a um atributo ou o campo de um item de dados. Por exemplo, você pode vincular o Text a propriedade de um item de menu para o atributo de texto em um elemento XML, definindo a TextField propriedade de um MenuItemBinding objeto. Você também pode vincular a um valor estático. Se você definir a Text propriedade de um MenuItemBinding objeto, todos os itens de menu ao qual o MenuItemBinding objeto é aplicado compartilham o mesmo valor de texto estático. Para obter mais informações sobre como acoplar as propriedades de um MenuItem o objeto para um valor, consulte MenuItemBinding.

Embora o DataBindings coleção pode ser preenchida por meio de programação, normalmente é definida declarativamente. Para especificar as ligações de item de menu, primeiro aninhar abrindo e fechando <DataBindings> marcas entre as marcas de abertura e fechamento da Menu controle. Em seguida, coloque <asp:MenuItemBinding> elementos entre a abertura e fechamento <DataBindings> marcas para cada item de menu que você deseja especificar.

O exemplo de código a seguir demonstra como usar o DataBindings coleção para definir a relação entre os campos de um XmlDataSource controle e os itens de menu em um Menu controle. 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>



Veja a seguir, dados de mapa de site de exemplo para o exemplo anterior.

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

.NET Framework

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

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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 do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft