SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Methode

  • Referenz

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Parameter

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

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

ArgumentOutOfRangeException

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.

Gilt für:

Weitere Informationen