Auf Englisch lesen

Freigeben über


SiteMapPath.CreateControlHierarchy Methode

Definition

Ü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.

C#
protected virtual void 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.

Gilt für:

Weitere Informationen