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 Explorer 4.0 и более поздние версии), также могут воспользоваться преимуществами заполнения узлов на стороне клиента. При включении этот элемент управления позволяет TreeView элементу управления динамически заполнять узел на клиенте при развертывании этого узла, что предотвращает необходимость обратной передачи на сервер. Дополнительные сведения о заполнения узлов на стороне клиента см. в разделе PopulateNodesFromClient.
При вызове события обработчик событий вызывается через делегат. Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".
Метод OnTreeNodePopulate также позволяет производным классам обрабатывать событие без присоединения делегата. Это предпочтительный способ обработки события в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении OnTreeNodePopulate(TreeNodeEventArgs) метода в производном классе обязательно вызовите OnTreeNodePopulate(TreeNodeEventArgs) метод для базового класса, чтобы зарегистрированные делегаты получали событие.
