SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) 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.
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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParameter
- 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
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.