SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 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.
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 -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)Parameter
- node
- SiteMapNode
Der SiteMapNode, der als Bezugspunkt für upLevel fungiert.
- 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 abgerufen und zwischengespeichert werden können.
Ausnahmen
upLevel ist kleiner als -1.
node ist null.
Hinweise
Die Standardmethode HintAncestorNodes sucht nur nach einem upLevel Parameter, der kleiner als -1 ist, und einen node Parameter, der lautet null. Da die XmlSiteMapProvider Klasse Websitezuordnungsinformationen im Arbeitsspeicher zwischenspeichert, wird die HintAncestorNodes Methode nicht verwendet.
Websitezuordnungsanbieter können die HintAncestorNodes Methode außer Kraft setzen, um einen optimierten Abruf von übergeordneten und Vorgängerknoten des angegebenen SiteMapNode Objekts auszuführen.
Der upLevel Parameter wird verwendet, um anzugeben, wie viele Ebenen von übergeordneten und Vorgängerknoten vom angegebenen SiteMapNodeKnoten durchlaufen werden sollen. Wenn weniger Ebenen vorhanden sind als angefordert, werden alle verfügbaren Vorgängerknoten innerhalb der angegebenen Grenze zurückgegeben. Falls bevorzugt, kann der übergeordnete Knoten mit der angegebenen SiteMapNode Eigenschaft ParentNode verknüpft werden.