Udostępnij za pośrednictwem


SiteMapPath.CreateControlHierarchy Metoda

Definicja

Sprawdza strukturę mapy witryny udostępnioną przez SiteMapProvider obiekt i tworzy kolekcję kontrolek podrzędnych na podstawie stylów i szablonów zdefiniowanych dla węzłów funkcjonalnych.

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

Wyjątki

Kontrolka SiteMapPath nie SiteMapProvider jest dostępna.

Uwagi

Metoda CreateControlHierarchy tworzy SiteMapNodeItem kontrolki, kojarzy je z odpowiednimi SiteMapNode obiektami od bieżącego dostawcy mapy lokacji i dodaje węzły do Controls kolekcji.

Metoda rozpoczyna się od znalezienia elementu , a następnie przechodzi w górę SiteMap.CurrentNodehierarchiczne drzewo SiteMapNode obiektów, tworząc element SiteMapNodeItem dla każdego z nich do momentu RootNode osiągnięcia. Po utworzeniu każdej z nich SiteMapNodeItem , ale przed jej powiązaniem z odpowiednią SiteMapNodemetodą jest wywoływana InitializeItem metoda . Metoda InitializeItem stosuje wszystkie szablony lub style zdefiniowane dla określonego typu węzła i tworzy i inicjuje wszystkie kontrolki podrzędne, które SiteMapNodeItem zawiera. InitializeItem Na koniec metoda dodaje do kolekcji kontrolki SiteMapNodeItem podrzędneControls.

Po zainicjowaniu każdej SiteMapNodeItem metody wywoływana OnItemCreated jest metoda. SiteMapNodeItem Następnie element jest powiązany z odpowiednim elementem SiteMapNodei OnDataBound jest wywoływany.

Metoda jest wywoływana CreateControlHierarchy z CreateChildControls metody .

Klasy rozszerzające kontrolkę zastępują metodęCreateControlHierarchy, aby zmienić sposób SiteMapNodeItem tworzenia lub dodawania kontrolek do kontrolkiSiteMapPath.SiteMapPath Manipulowanie poszczególnymi elementami węzłów jest wykonywane w metodzie InitializeItem , a większość klas, które rozszerzają SiteMapPath zastąpienie tylko tej metody.

Dotyczy

Zobacz też