SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, 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 Siteübersichtsknoten im unmittelbaren Umfeld des aktuellen Knotens bereit.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNodeParameter
- upLevel
- Int32
Die Anzahl der mittelbar übergeordneten SiteMapNode-Generationen, die abgerufen werden sollen. 0 (null) gibt an, dass keine mittelbar übergeordneten Knoten abgerufen werden, und -1 gibt an, dass alle mittelbar übergeordneten Knoten vom Anbieter abgerufen und zwischengespeichert werden können.
- downLevel
- Int32
Die Anzahl der unmittelbar untergeordneten SiteMapNode-Generationen, die abgerufen werden sollen. 0 (null) gibt an, dass keine mittelbar untergeordneten Knoten abgerufen werden, und -1 gibt an, dass alle mittelbar untergeordneten 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 oder downLevel ist kleiner als -1.
Hinweise
Die Standardimplementierung der GetCurrentNodeAndHintNeighborhoodNodes -Methode gibt die CurrentNode -Eigenschaft zurück. Siteübersichtsanbieter können jedoch die GetCurrentNodeAndHintNeighborhoodNodes -Methode überschreiben und eine optimierte Implementierung bereitstellen, die benutzerdefinierte Zwischenspeicherungsmechanismen verwendet, um das aktuelle SiteMapNode Objekt sowie Objekte zurückzugeben, SiteMapNode die sich in der Nähe des aktuellen SiteMapNodebefinden.
Der upLevel Parameter wird verwendet, um anzugeben, wie viele Ebenen von übergeordneten und übergeordneten Knoten abgerufen und zwischengespeichert werden sollen, zusammen mit den unmittelbaren untergeordneten Elementen. Der downLevel Parameter wird verwendet, um anzugeben, wie viele Ebenen von Nachfolgerknoten aus dem aktuellen SiteMapNode abgerufen werden sollen. Wenn dies bevorzugt ist, können die Vorgänger- und Nachfolgerknoten mit dem verknüpft werden, das SiteMapNode vom zurückgegeben wird.
GetCurrentNodeAndHintNeighborhoodNodes-Methode mit den ParentNode Eigenschaften und ChildNodes Wenn weniger übergeordnete oder untergeordnete Knotenebenen vorhanden sind, als von upLevel oder downLevelangegeben sind, werden nur die verfügbaren Knotenebenen abgerufen.
Die XmlSiteMapProvider -Klasse, die der Standardmäßige Siteübersichtsanbieter für ASP.NET ist, speichert die gesamte Siteübersicht im Arbeitsspeicher zwischen, was zu wenig oder keinem Mehraufwand bei der Abfrage von XmlSiteMapProvider für bestimmte SiteMapNode Objekte führt.
