SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Methode

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

Parameter

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.

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

Ausnahmen

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

Hinweise

Die Standard Implementierung GetCurrentNodeAndHintNeighborhoodNodes der-Methode gibt die CurrentNode -Eigenschaft zurück. Site Übersichts Anbieter können jedoch die GetCurrentNodeAndHintNeighborhoodNodes -Methode überschreiben und eine optimierte Implementierung bereitstellen, die benutzerdefinierte zwischen Speicherungs Mechanismen verwendet, um den aktuellen -Objekt sowie SiteMapNode -Objekte, die sich in der Nähe des aktuellen SiteMapNodebefinden. SiteMapNodeThe 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 SiteMapNode vom aktuellen 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 SiteMapNode mit dem verknüpft werden, der vomIf preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the

GetCurrentNodeAndHintNeighborhoodNodes-Methode, mithilfe ParentNode der ChildNodes -Eigenschaft und der-Eigenschaft.GetCurrentNodeAndHintNeighborhoodNodes method, using the ParentNode and ChildNodes properties. Wenn es weniger Vorgänger-oder untergeordnete Knoten Ebenen gibt, als upLevel von downLeveloder angegeben 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 XmlSiteMapProvider von für SiteMapNode bestimmte Objekte 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.

Gilt für:

Siehe auch