SiteMapPath.CreateControlHierarchy Метод

Определение

Проверяет структуру карты веб-узла, предоставленную SiteMapProvider и создает коллекцию дочерних элементов управления, основываясь на стилях и шаблона, определенных для рабочих узлов.Examines the site map structure provided by the SiteMapProvider and builds a child controls collection based on the styles and templates defined for the functional nodes.

protected:
 virtual void CreateControlHierarchy();
protected virtual void CreateControlHierarchy ();
abstract member CreateControlHierarchy : unit -> unit
override this.CreateControlHierarchy : unit -> unit
Protected Overridable Sub CreateControlHierarchy ()

Исключения

SiteMapProvider не доступен для элемента управления SiteMapPath.No SiteMapProvider is available to the SiteMapPath control.

Комментарии

Метод создает SiteMapNodeItem элементы управления, связывает их с соответствующими SiteMapNode объектами из текущего Controls поставщика карт веб-узла и добавляет узлы в коллекцию. CreateControlHierarchyThe CreateControlHierarchy method creates SiteMapNodeItem controls, associates them with the corresponding SiteMapNode objects from the current site map provider, and adds the nodes to the Controls collection.

SiteMap.CurrentNodeМетод начинается с поиска, а затем проходит по иерархическому SiteMapNode дереву объектов, создавая SiteMapNodeItem для каждого из них, пока RootNode не будет достигнут.The method begins by finding the SiteMap.CurrentNode, and then walks up the hierarchical tree of SiteMapNode objects, creating a SiteMapNodeItem for each one until the RootNode is reached. После создания SiteMapNodeItem каждого из InitializeItem них вызывается метод, но до его привязки SiteMapNodeк соответствующему объекту.After each SiteMapNodeItem is created, but before it is bound to its corresponding SiteMapNode, the InitializeItem method is called. Метод применяет все шаблоны или стили, определенные для конкретного типа узла, и создает и инициализирует все дочерние элементы управления SiteMapNodeItem , которые содержит. InitializeItemThe InitializeItem method applies any templates or styles defined for a particular node type and creates and initializes any child controls that the SiteMapNodeItem contains. Наконец, InitializeItem метод добавляет дочерние элементы управления SiteMapNodeItem Controls в коллекцию.Finally, the InitializeItem method adds the child controls of the SiteMapNodeItem to the Controls collection.

После инициализации SiteMapNodeItem каждой из OnItemCreated них вызывается метод.After each SiteMapNodeItem is initialized, the OnItemCreated method is called. Затем объект SiteMapNodeItem привязывается к соответствующему SiteMapNodeметоду, и OnDataBound вызывается.Then the SiteMapNodeItem is bound to its corresponding SiteMapNode, and OnDataBound is called.

Метод вызывается из CreateChildControlsметода. CreateControlHierarchyThe CreateControlHierarchy method is called from the CreateChildControls method.

Классы, расширяющие SiteMapPath элемент управления, CreateControlHierarchy переопределяют SiteMapNodeItem метод, чтобы изменить способ создания элементов управления или их SiteMapPath добавления в элемент управления.Classes that extend the SiteMapPath control override the CreateControlHierarchy method to alter how the SiteMapNodeItem controls are created or added to the SiteMapPath control. Обработка отдельных элементов узла выполняется в InitializeItem методе, и большинство классов, расширяющих SiteMapPath его, переопределяют только этот метод.The manipulation of individual node items is performed in the InitializeItem method, and most classes that extend SiteMapPath override that method only.

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

Дополнительно