TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Aumenta o TreeNodePopulate evento do TreeView controlo.
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
A que contém dados de TreeNodeEventArgs eventos.
Observações
Por vezes, não é prático pré-definir estaticamente a estrutura da árvore devido ao tamanho dos dados ou ao conteúdo personalizado que depende da entrada do utilizador. Por causa disso, o controlo TreeView suporta a população dinâmica de nós. Quando a PopulateOnDemand propriedade de um nó é definida para true, esse nó é preenchido em tempo de execução quando o nó é expandido.
Para povoar um nó dinamicamente, primeiro defina a PopulateOnDemand propriedade do nó como true. De seguida, defina um método de gestão de eventos para o TreeNodePopulate evento que preenche programaticamente o nó. Um método típico de gestão de eventos recupera dados de nós de uma fonte de dados, coloca os dados numa estrutura de nós e depois adiciona a estrutura de nós à ChildNodes coleção do nó que está a ser povoado. Uma estrutura de nó é criada adicionando TreeNode objetos à ChildNodes coleção de um nó pai.
Note
Quando a PopulateOnDemand propriedade para um nó é definida para true, o nó deve ser povoado dinamicamente. Não podes aninizar declarativamente outro nó abaixo dele; caso contrário, ocorrerá um erro na página.
Navegadores suportados (Microsoft Internet Explorer navegadores compatíveis com 4.0 e posteriores) também podem tirar partido da população de nós do lado do cliente. Quando ativado, isto permite que o TreeView controlo preencha dinamicamente um nó no cliente quando esse nó é expandido, o que evita a necessidade de publicar de volta ao servidor. Para mais informações sobre a população de nós do lado do cliente, veja PopulateNodesFromClient.
Levantar um evento invoca o gestor de eventos através de um delegado. Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.
O OnTreeNodePopulate método também permite que classes derivadas tratem do evento sem anexar um delegado. Esta é a técnica preferida para lidar com o evento numa classe derivada.
Notas para Herdeiros
Ao substituir o OnTreeNodePopulate(TreeNodeEventArgs) método numa classe derivada, certifique-se de chamar o OnTreeNodePopulate(TreeNodeEventArgs) método para a classe base para que os delegados registados recebam o evento.