SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Method

Definition

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.Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the site map nodes in the proximity of the current node.

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

Parameters

upLevel
Int32

Die Anzahl der mittelbar übergeordneten SiteMapNode-Generationen, die abgerufen werden sollen.The number of ancestor SiteMapNode generations to fetch. 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.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors might be retrieved and cached by the provider.

downLevel
Int32

Die Anzahl der unmittelbar untergeordneten SiteMapNode-Generationen, die abgerufen werden sollen.The number of child SiteMapNode generations to fetch. 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.0 indicates no descendant nodes are retrieved and a -1 indicates that all descendant nodes might be retrieved and cached by the provider.

Returns

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.A SiteMapNode that represents the currently requested page; otherwise, null, if the SiteMapNode is not found or cannot be returned for the current user.

Exceptions

upLevel oder downLevel ist kleiner als -1.upLevel or downLevel is less than -1.

Remarks

Die Standard Implementierung der GetCurrentNodeAndHintNeighborhoodNodes Methode gibt die CurrentNode-Eigenschaft zurück. Allerdings können Site Übersichts Anbieter die GetCurrentNodeAndHintNeighborhoodNodes Methode überschreiben und eine optimierte Implementierung bereitstellen, die benutzerdefinierte zwischen Speicherungs Mechanismen verwendet, um das aktuelle SiteMapNode Objekt zurückzugeben, sowie SiteMapNode Objekte, die sich in der Nähe des aktuellen SiteMapNodebefinden.The default implementation of the GetCurrentNodeAndHintNeighborhoodNodes method returns the CurrentNode property; however, site map providers can override the GetCurrentNodeAndHintNeighborhoodNodes method and provide an optimized implementation that uses custom caching mechanisms to return the current SiteMapNode object, as well as SiteMapNode objects that are in the proximity of the current SiteMapNode.

Der upLevel-Parameter wird verwendet, um anzugeben, wie viele Ebenen von übergeordneten und übergeordneten Knoten zusammen mit den unmittelbar untergeordneten Knoten abgerufen und zwischengespeichert werden sollen.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to retrieve and cache, along with their immediate children. Der downLevel-Parameter wird verwendet, um anzugeben, wie viele Ebenen von Nachfolger Knoten von der aktuellen SiteMapNode abgerufen werden sollen.The downLevel parameter is used to specify how many levels of descendant nodes from the current SiteMapNode to retrieve. Wenn Sie dies bevorzugen, können der Vorgänger Knoten und der Nachfolger Knoten mit dem SiteMapNode verknüpft werden, das von derIf preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the

GetCurrentNodeAndHintNeighborhoodNodes Methode mithilfe der Eigenschaften ParentNode und ChildNodes.GetCurrentNodeAndHintNeighborhoodNodes method, using the ParentNode and ChildNodes properties. Wenn es weniger Vorgänger-oder untergeordnete Knoten Ebenen gibt, als durch upLevel oder downLevelangegeben werden, werden nur die verfügbaren Knoten abgerufen.If there are fewer ancestor or child node levels than are specified by upLevel or downLevel, only those that are available are retrieved.

Die XmlSiteMapProvider-Klasse, bei der es sich um den Standard-Site Übersichts Anbieter für ASP.net handelt, speichert die gesamte Site Map im Speicher zwischen, was bei der Abfrage der XmlSiteMapProvider nach bestimmten SiteMapNode Objekten zu wenig oder gar keinen Aufwand führt.The XmlSiteMapProvider class, which is the default site map provider for ASP.NET, caches the entire site map in memory, which results in little or no overhead when querying the XmlSiteMapProvider for specific SiteMapNode objects.

Applies to

See also