Freigeben über


SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Methode

Definition

Stellt Siteübersichtsanbietern eine optimierte Nachschlagemethode zum Abrufen des Knotens für die gerade angeforderte Seite und zum Abrufen der mittelbar und unmittelbar übergeordneten Knoten für die aktuelle Seite bereit.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);
abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

Parameter

upLevel
Int32

Die Anzahl der Generationen mittelbar übergeordneter Siteübersichtsknoten, die abgerufen werden sollen. Der Wert -1 gibt an, dass alle mittelbar übergeordneten Knoten vom Anbieter abgerufen und zwischengespeichert werden können.

Gibt zurück

SiteMapNode

Ein SiteMapNode, der die gerade angeforderte Seite darstellt. Andernfalls null, wenn der SiteMapNode nicht gefunden wird oder für den aktuellen Benutzer nicht zurückgegeben werden kann.

Ausnahmen

upLevel ist kleiner als -1.

Hinweise

Die Standardimplementierung der GetCurrentNodeAndHintAncestorNodes Methode gibt die CurrentNode Eigenschaft zurück. Websitezuordnungsanbieter können die GetCurrentNodeAndHintAncestorNodes Methode jedoch außer Kraft setzen und eine optimierte Implementierung bereitstellen, die benutzerdefinierte Zwischenspeicherungsmechanismen verwendet, um die aktuellen Sowie die übergeordneten und übergeordneten Knoten des übergeordneten SiteMapNodeElements zurückzugeben.

Der upLevel Parameter wird verwendet, um anzugeben, wie viele Ebenen von übergeordneten und vorgängerknoten abgerufen werden sollen. Wenn bevorzugt, können die übergeordneten und übergeordneten Knoten mit dem SiteMapNode Objekt verknüpft werden, das von der Methode zurückgegeben wird, mithilfe der GetCurrentNodeAndHintAncestorNodes ParentNode Eigenschaft.

Die XmlSiteMapProvider Klasse, die der Standardwebsitezuordnungsanbieter für ASP.NET ist, speichert die gesamte Websitezuordnung im Arbeitsspeicher zwischen, was zu wenig oder keinem Aufwand bei der Abfrage für XmlSiteMapProvider bestimmte SiteMapNode Objekte führt.

Gilt für

Siehe auch