TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Provoca el evento TreeNodePopulate del control 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

Objeto TreeNodeEventArgs que contiene datos de eventos.

Comentarios

A veces, no resulta práctico predefinir estáticamente la estructura de árbol debido al tamaño de los datos o al contenido personalizado que depende de la entrada del usuario. Por este motivo, el control admite el TreeView rellenado dinámico de nodos. Cuando la PopulateOnDemand propiedad de un nodo se establece trueen , ese nodo se rellena en tiempo de ejecución cuando se expande el nodo.

Para rellenar un nodo dinámicamente, establezca primero la PopulateOnDemand propiedad del nodo trueen . A continuación, defina un método de control de eventos para el TreeNodePopulate evento que rellena mediante programación el nodo. Un método típico de control de eventos recupera datos de nodo de un origen de datos, coloca los datos en una estructura de nodo y, a continuación, agrega la estructura del nodo a la ChildNodes colección del nodo que se está rellenando. Se crea una estructura de nodo agregando TreeNode objetos a la ChildNodes colección de un nodo primario.

Nota

Cuando la PopulateOnDemand propiedad de un nodo se establece trueen , el nodo debe rellenarse dinámicamente. No se puede anidar mediante declaración otro nodo debajo de él; De lo contrario, se producirá un error en la página.

Los exploradores compatibles (exploradores compatibles con Microsoft Internet Explorer 4.0 y versiones posteriores) también pueden aprovechar el rellenado de nodos del lado cliente. Cuando se habilita, esto permite que el TreeView control rellene un nodo en el cliente dinámicamente cuando se expanda ese nodo, lo que evita la necesidad de volver a publicar en el servidor. Para obtener más información sobre el rellenado de nodos del lado cliente, vea PopulateNodesFromClient.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.

El método OnTreeNodePopulate también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al invalidar el OnTreeNodePopulate(TreeNodeEventArgs) método en una clase derivada, asegúrese de llamar al OnTreeNodePopulate(TreeNodeEventArgs) método de la clase base para que los delegados registrados reciban el evento.

Se aplica a

Consulte también