SiteMapPath.CreateControlHierarchy Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überprüft die von SiteMapProvider bereitgestellte Siteübersichtsstruktur und erstellt eine Auflistung untergeordneter Steuerelemente basierend auf den für die funktionalen Knoten definierten Stilen und Vorlagen.
protected:
virtual void CreateControlHierarchy();protected virtual void CreateControlHierarchy ();abstract member CreateControlHierarchy : unit -> unit
override this.CreateControlHierarchy : unit -> unitProtected Overridable Sub CreateControlHierarchy ()Ausnahmen
Für das SiteMapProvider-Steuerelement ist kein SiteMapPath verfügbar.
Hinweise
Die CreateControlHierarchy -Methode erstellt SiteMapNodeItem Steuerelemente, ordnet sie den entsprechenden SiteMapNode Objekten des aktuellen Siteübersichtsanbieters zu und fügt die Knoten der Controls Auflistung hinzu.
Die -Methode beginnt mit der Suche nach , SiteMap.CurrentNodeund führt dann die hierarchische Struktur der SiteMapNode -Objekte durch, und erstellt für jedes Objekt eine SiteMapNodeItem , bis die RootNode erreicht ist. Nachdem jede SiteMapNodeItem erstellt wurde, aber bevor sie an den entsprechenden SiteMapNodegebunden ist, wird die InitializeItem -Methode aufgerufen. Die InitializeItem -Methode wendet alle Vorlagen oder Stile an, die für einen bestimmten Knotentyp definiert sind, und erstellt und initialisiert alle untergeordneten Steuerelemente, die enthalten SiteMapNodeItem sind. Schließlich fügt die InitializeItem -Methode der Auflistung die untergeordneten SiteMapNodeItem Steuerelemente von hinzu Controls .
Nachdem jede SiteMapNodeItem initialisiert wurde, wird die OnItemCreated -Methode aufgerufen. Dann ist der an den SiteMapNodeItem entsprechenden SiteMapNodegebunden und OnDataBound wird aufgerufen.
Die CreateControlHierarchy -Methode wird von der CreateChildControls -Methode aufgerufen.
Klassen, die das SiteMapPath Steuerelement erweitern, überschreiben die CreateControlHierarchy -Methode, um zu ändern, wie die SiteMapNodeItem Steuerelemente erstellt oder dem SiteMapPath Steuerelement hinzugefügt werden. Die Bearbeitung einzelner Knotenelemente wird in der -Methode ausgeführt, und die InitializeItem meisten Klassen, die erweitern SiteMapPath , überschreiben nur diese Methode.
