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

Propriedade Menu.DataBindings

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

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

Valor da Propriedade

Type: System.Web.UI.WebControls.MenuItemBindingCollection

Um MenuItemBindingCollection que representa a relação entre um item de dados e o item de menu ao qual ele está se associando.

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

Ao definir a relação entre um item de dados e um item de menu, você deve especificar ambos os critérios de associação e a propriedade de um item de dados para associar a. Os critérios indicam quando um item de dados deve ser associado 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 a associação. Por exemplo, se você especificar uma profundidade de 0, todos os itens na estrutura de árvore no nível 0 são vinculados usando a associação de 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 estão em conflito entre si, o Menu controle aplica-se as associações de item de menu na seguinte ordem de precedência:

  1. O MenuItemBinding 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 associação são estabelecidos, em seguida, você pode associar uma propriedade de um MenuItem objeto que pode ser associado a um atributo ou o campo de um item de dados. Por exemplo, você pode vincular o Text propriedade de um item de menu para o atributo de texto em um elemento XML definindo o TextField propriedade de um MenuItemBinding objeto. Você também pode associar a um valor estático. Se você definir o Text propriedade de um MenuItemBinding objeto, todos os itens de menu no qual o MenuItemBinding objeto é aplicado compartilham o mesmo valor de texto estático. Para obter mais informações sobre como associar as propriedades de um MenuItem para um valor de objeto, consulte MenuItemBinding.

Embora o DataBindings coleção pode ser preenchida por meio de programação, é geralmente definida declarativamente. Para especificar as associações de item de menu, primeiro aninhar abrindo e fechando <DataBindings> marcas entre as marcas de abertura e fechamento do 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 esse exemplo funcione corretamente, você deve copiar os dados XML de exemplo abaixo em um arquivo chamado map.


<%@ 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 seguinte é 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
Disponível desde 2.0
Retornar ao início
Mostrar: