SiteMapPath.CreateControlHierarchy Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Sprawdza strukturę mapy witryny udostępnioną przez SiteMapProvider program 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 -> unitProtected Overridable Sub CreateControlHierarchy ()Wyjątki
Kontrolka SiteMapPath nie SiteMapProvider jest dostępna.
Uwagi
Metoda CreateControlHierarchy tworzy SiteMapNodeItem kontrolki, kojarzy je z odpowiednimi SiteMapNode obiektami z bieżącego dostawcy mapy lokacji i dodaje węzły do Controls kolekcji.
Metoda rozpoczyna się od znalezienia SiteMap.CurrentNodeobiektu , a następnie przechodzi w górę hierarchiczne drzewo SiteMapNode obiektów, tworząc SiteMapNodeItem element dla każdego z nich do momentu RootNode osiągnięcia. Po utworzeniu każdej SiteMapNodeItem z nich, 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 SiteMapNodeItem wszystkie kontrolki podrzędne, które zawiera. InitializeItem Na koniec metoda dodaje kontrolki podrzędne SiteMapNodeItem obiektu do kolekcjiControls.
Po zainicjowaniu każdej z nich SiteMapNodeItem wywoływana OnItemCreated jest metoda . Następnie element SiteMapNodeItem jest powiązany z odpowiadającym SiteMapNodemu elementem , i OnDataBound jest wywoływany.
Metoda CreateControlHierarchy jest wywoływana CreateChildControls z 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 przesłonięcia tylko tę metodę.