Поделиться через


TreeView.OnTreeNodePopulate(TreeNodeEventArgs) Метод

Определение

Вызывает событие TreeNodePopulate элемента управления 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)

Параметры

e
TreeNodeEventArgs

Объект TreeNodeEventArgs, содержащий данные события.

Комментарии

Иногда нецелесообразно статически предопределить структуру дерева из-за размера данных или пользовательского содержимого, зависящее от введенных пользователем данных. Поэтому элемент управления поддерживает динамическое заполнение TreeView узлов. Если свойству PopulateOnDemand узла присвоено значение true, этот узел заполняется во время выполнения при развертывании узла.

Чтобы динамически заполнить узел, сначала задайте свойству PopulateOnDemand узла значение true. Затем определите метод обработки событий для TreeNodePopulate события, которое программно заполняет узел. Типичный метод обработки событий извлекает данные узла из источника данных, помещает данные в структуру узла, а затем добавляет структуру узла в ChildNodes коллекцию заполняемого узла. Структура узла создается путем добавления TreeNode объектов в коллекцию ChildNodes родительского узла.

Примечание

Если свойству PopulateOnDemand узла присвоено значение true, узел должен заполняться динамически. Нельзя декларативно вложить под ним другой узел; В противном случае на странице возникнет ошибка.

Поддерживаемые браузеры (браузеры, совместимые с Microsoft Internet Обозреватель 4.0 и более поздние версии) также могут использовать преимущества заполнения клиентских узлов. Если этот параметр включен, элемент управления может TreeView динамически заполнять узел на клиенте при развертывании этого узла, что предотвращает необходимость обратной передачи данных на сервер. Дополнительные сведения о заполнении узла на стороне клиента см. в разделе PopulateNodesFromClient.

При возникновении события через делегат вызывается обработчик события. Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.

Метод OnTreeNodePopulate также позволяет производным классам обрабатывать событие, не присоединяя делегат. Это предпочтительная методика обработки событий в производном классе.

Примечания для тех, кто наследует этот метод

При переопределении OnTreeNodePopulate(TreeNodeEventArgs) метода в производном классе обязательно вызовите OnTreeNodePopulate(TreeNodeEventArgs) метод для базового класса, чтобы зарегистрированные делегаты получали событие.

Применяется к

См. также раздел