Compartilhar via


TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Método

Definição

Aciona o evento TreeNodePopulate do controle TreeView.

protected:
 virtual void OnTreeNodePopulate(System::Web::UI::WebControls::TreeNodeEventArgs ^ e);
protected virtual void OnTreeNodePopulate (System.Web.UI.WebControls.TreeNodeEventArgs e);
abstract member OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
override this.OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

Parâmetros

e
TreeNodeEventArgs

Um TreeNodeEventArgs que contém dados do evento.

Comentários

Às vezes, não é prático predefinir estaticamente a estrutura da árvore devido ao tamanho dos dados ou conteúdo personalizado que depende da entrada do usuário. Por isso, o controle dá suporte à TreeView população de nós dinâmicos. Quando a PopulateOnDemand propriedade de um nó é definida truecomo , esse nó é preenchido em tempo de execução quando o nó é expandido.

Para preencher um nó dinamicamente, primeiro defina a PopulateOnDemand propriedade do nó truecomo . Em seguida, defina um método de manipulação de eventos para o TreeNodePopulate evento que preenche programaticamente o nó. Um método típico de manipulação de eventos recupera dados de nó de uma fonte de dados, coloca os dados em uma estrutura de nó e adiciona a estrutura do nó à ChildNodes coleção do nó que está sendo preenchido. Uma estrutura de nó é criada adicionando TreeNode objetos à ChildNodes coleção de um nó pai.

Observação

Quando a PopulateOnDemand propriedade de um nó é definida truecomo , o nó deve ser preenchido dinamicamente. Você não pode aninhar declarativamente outro nó abaixo dele; caso contrário, ocorrerá um erro na página.

Navegadores com suporte (Navegadores compatíveis com a Internet da Microsoft Explorer 4.0 e posteriores) também podem aproveitar a população de nós do lado do cliente. Quando habilitado, isso permite que o TreeView controle preencha um nó no cliente dinamicamente quando esse nó é expandido, o que impede a necessidade de postar de volta no servidor. Para obter mais informações sobre a população de nós do lado do cliente, consulte PopulateNodesFromClient.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

O OnTreeNodePopulate método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir o OnTreeNodePopulate(TreeNodeEventArgs) método em uma classe derivada, certifique-se de chamar o OnTreeNodePopulate(TreeNodeEventArgs) método para a classe base para que os delegados registrados recebam o evento.

Aplica-se a

Confira também