Freigeben über

SiteMapPath.CreateControlHierarchy Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ü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 -> unit
Protected Overridable Sub CreateControlHierarchy ()

Ausnahmen

HttpException

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