Compartilhar via


Seleção, Navegação, e Caixas de Seleção no Controle de Servidor Web TreeView

O controle ASP.NET TreeView torna fácil a resposta quando um usuário clicar em um nó, ou alterar o comportamento de um nó para fazê-lo funcionar como um hiperlink.Além disso, você pode usar o controle TreeView para exibir caixas de seleção próximas a nós individuais para que os usuários possam selecionar vários nós ao mesmo tempo.

Seleção e Navegação

Cada nó tem uma propriedade Text e uma propriedade Value.O valor da propriedade Text é exibida no controle TreeView, enquanto a propriedade Value é usada para armazenar quaisquer dados adicionais sobre o nó, como dados passados para o evento de postagem que está associado com o nó.

Quando um nó do controle TreeView é clicado, ele pode gerar um evento de seleção (via postback) ou navegar para outra página.Quando a propriedade href não está definida, clicando em um nó vai gerar um evento SelectedNodeChanged que pode ser manipulado para fornecer uma funcionalidade personalizada.Você também pode verificar a propriedade Selected de um nó para determinar se ele está selecionado.Definindo dessa propriedade como true ou chamando o método Select no nó fará com que o nó seja selecionado por meio de programação.

Cada nó também tem uma propriedade SelectAction que pode ser usada para especificar ações que ocorrerão quando o nó é clicado, como expandir ou recolher o nó.Em vez de gerar um evento SelectedNodeChanged para navegar para uma página quando um nó é clicado, defina a propriedade href do nó com um valor que seja uma string vazia ("").

Para obter mais informações sobre como manipular eventos de seleção, consulte SelectedNode.Para obter mais informações sobre o modo de navegação, consulte href.Para obter mais informações sobre como definir a propriedade href ao vincular dados, consulte hrefField.

Caixas de Seleção

Em casos onde você deseja que os usuários possam selecionar vários nós, você pode usar o controle TreeView para exibir um caixa de seleção perto da imagem de um nó.Quando a propriedade ShowCheckBoxes é definida para um TreeNodeType diferente de TreeNodeType.None, caixas de seleção são exibidas ao lado dos nós especificados.Quando caixas de seleção são exibidas, você pode usar o evento TreeNodeCheckChanged para executar sua rotina personalizada sempre que o estado de uma caixa de seleção alterar entre postagens para o servidor.Na próxima vez em que a página for postada para o servidor, a propriedade CheckedNodes é preenchida com os nós selecionados.

O controle TreeView não expõe uma propriedade AutoPostBack.Assim, para enviar seleções de caixa de seleção, você deve colocar um controle, como um controle de servidor Web Button, na página para postar informações de volta para o servidor.

Para obter mais informações sobre como usar caixas de seleção com o controle TreeView ASP.NET, consulte CheckBoxes.

Consulte também

Conceitos

Preenchendo Nós de Árvore no Controle do Servidor Web TreeView

Referência

Visão geral do Controle do Servidor Web TreeView