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 -> unitProtected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)Параметры
Объект TreeNodeEventArgs, содержащий данные события.
Комментарии
Иногда нецелесообразно статически предопределить структуру дерева из-за размера данных или пользовательского содержимого, зависящее от введенных пользователем данных. Поэтому элемент управления поддерживает динамическое заполнение TreeView узлов. Если свойству PopulateOnDemand узла присвоено значение true, этот узел заполняется во время выполнения при развертывании узла.
Чтобы динамически заполнить узел, сначала задайте свойству PopulateOnDemand узла значение true. Затем определите метод обработки событий для TreeNodePopulate события, которое программно заполняет узел. Типичный метод обработки событий извлекает данные узла из источника данных, помещает данные в структуру узла, а затем добавляет структуру узла в ChildNodes коллекцию заполняемого узла. Структура узла создается путем добавления TreeNode объектов в коллекцию ChildNodes родительского узла.
Примечание
Если свойству PopulateOnDemand узла присвоено значение true, узел должен заполняться динамически. Нельзя декларативно вложить под ним другой узел; В противном случае на странице возникнет ошибка.
Поддерживаемые браузеры (браузеры, совместимые с Microsoft Internet Обозреватель 4.0 и более поздние версии) также могут использовать преимущества заполнения клиентских узлов. Если этот параметр включен, элемент управления может TreeView динамически заполнять узел на клиенте при развертывании этого узла, что предотвращает необходимость обратной передачи данных на сервер. Дополнительные сведения о заполнении узла на стороне клиента см. в разделе PopulateNodesFromClient.
При возникновении события через делегат вызывается обработчик события. Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.
Метод OnTreeNodePopulate также позволяет производным классам обрабатывать событие, не присоединяя делегат. Это предпочтительная методика обработки событий в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении OnTreeNodePopulate(TreeNodeEventArgs) метода в производном классе обязательно вызовите OnTreeNodePopulate(TreeNodeEventArgs) метод для базового класса, чтобы зарегистрированные делегаты получали событие.
