SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Method

Definition

Stellt eine Methode bereit, die Siteübersichtsanbieter überschreiben können, um mindestens eine Ebene mittelbar und unmittelbar übergeordneter Knoten (relativ zum angegebenen SiteMapNode-Objekt) optimal abzurufen.Provides a method that site map providers can override to perform an optimized retrieval of one or more levels of parent and ancestor nodes, relative to the specified SiteMapNode object.

public:
 virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);
public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);
abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unit
Public Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)

Parameter

node
SiteMapNode SiteMapNode SiteMapNode SiteMapNode

Der SiteMapNode, der als Bezugspunkt für upLevel fungiert.The SiteMapNode that acts as a reference point for upLevel.

upLevel
Int32 Int32 Int32 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 abgerufen und zwischengespeichert werden können.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors might be retrieved and cached.

Ausnahmen

Hinweise

Die Standard HintAncestorNodes Methode überprüft nur einen upLevel Parameter, der kleiner als-1 ist, und node einen Parameter, nullder ist.The default HintAncestorNodes method only checks for an upLevel parameter that is less than -1 and a node parameter that is null. Da die XmlSiteMapProvider -Klasse Site Übersichts Informationen im Arbeitsspeicher zwischen HintAncestorNodes speichert, wird die-Methode nicht verwendet.Because the XmlSiteMapProvider class caches site map information in memory, the HintAncestorNodes method is not used.

Site Übersichts Anbieter können die HintAncestorNodes -Methode überschreiben, um ein optimiertes Abrufen von übergeordneten Knoten und Vorgänger Knoten des angegebenen SiteMapNode Objekts auszuführen.Site map providers can override the HintAncestorNodes method to perform an optimized retrieval of parent and ancestor nodes of the specified SiteMapNode object.

Der upLevel -Parameter wird verwendet, um anzugeben, wie viele Ebenen von übergeordneten und übergeordneten Knoten SiteMapNodevom angegebenen durchlaufen werden sollen.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to traverse from the specified SiteMapNode. Wenn weniger Ebenen vorhanden sind, als angefordert werden, werden alle verfügbaren übergeordneten Knoten innerhalb der angegebenen Grenze zurückgegeben.If fewer levels exist than are requested, all available ancestor nodes are returned within the specified bound. Wenn dies gewünscht ist, kann der übergeordnete Knoten mithilfe der SiteMapNode ParentNode -Eigenschaft mit dem angegebenen verknüpft werden.If preferred, the parent node can be linked to the specified SiteMapNode using the ParentNode property.

Gilt für:

Siehe auch