Compartilhar via

MenuItem.Selected Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define um valor que indica se o item de menu atual está selecionado em um controle Menu.

public:
 property bool Selected { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public bool Selected { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.Selected : bool with get, set
Public Property Selected As Boolean

Valor da propriedade

Boolean

true para indicar que o item de menu atual está selecionado em um controle Menu; caso contrário, false. O padrão é false.

Atributos
BrowsableAttribute

Exemplos

O exemplo a seguir demonstra como usar a Selected propriedade para selecionar um item de menu específico em um Menu controle quando a página é carregada pela primeira vez. Para que este exemplo funcione corretamente, você deve copiar os dados do mapa do site de exemplo abaixo para um arquivo chamado Web.sitemap.


<%@ 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 NavigationMenu_MenuItemDataBound(Object sender, MenuEventArgs e)
  {
    // Get the menu item being bound to data.
    MenuItem item = e.Item;

    // Use the Selected property to select the Home 
    // menu item when the page is first loaded.
    if (item.Text == "Home")
    {
      item.Selected = true;
    }
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Selected Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Selected Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        onmenuitemdatabound="NavigationMenu_MenuItemDataBound" 
        runat="server">
        
        <staticselectedstyle backcolor="Yellow"/>
        
      </asp:menu>
      
      <asp:sitemapdatasource id="MenuSource"
        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 NavigationMenu_MenuItemDataBound(ByVal sender As Object, ByVal e As MenuEventArgs)

    ' Get the menu item being bound to data.
    Dim item As MenuItem = e.Item

    ' Use the Selected property to select the Home 
    ' menu item when the page is first loaded.
    If item.Text = "Home" Then
    
      item.Selected = True
    
    End If
      
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Selected Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Selected Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        onmenuitemdatabound="NavigationMenu_MenuItemDataBound" 
        runat="server">
        
        <staticselectedstyle backcolor="Yellow"/>
        
      </asp:menu>
      
      <asp:sitemapdatasource id="MenuSource"
        runat="server"/>        

    </form>
  </body>
</html>

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

<siteMap>

<siteMapNode url="~\Home.aspx"

title="Home"

description="Home">

<siteMapNode url="~\Music.aspx"

title="Music"

description="Music">

<siteMapNode url="~\Classical.aspx"

title="Classical"

description="Classical"/>

<siteMapNode url="~\Rock.aspx"

title="Rock"

description="Rock"/>

<siteMapNode url="~\Jazz.aspx"

title="Jazz"

description="Jazz"/>

</siteMapNode>

<siteMapNode url="~\Movies.aspx"

title="Movies"

description="Movies">

<siteMapNode url="~\Action.aspx"

title="Action"

description="Action"/>

<siteMapNode url="~\Drama.aspx"

title="Drama"

description="Drama"/>

<siteMapNode url="~\Musical.aspx"

title="Musical"

description="Musical"/>

</siteMapNode>

</siteMapNode>

</siteMap>

Comentários

Use a Selected propriedade para especificar ou determinar se o item de menu atual está selecionado.

Observação

Embora a propriedade possa ser usada para determinar se um item de menu está selecionado, é mais comum usar a SelectedItem propriedade.

Somente um item de menu pode ser selecionado por vez no Menu controle.

Aplica-se a

Confira também