TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitProtected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)Parâmetros
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.
