SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Yöntem

Tanım

Belirtilen SiteMapNode nesne için bir üst düğüm alınırken ve alt düğümleri getirilirken site haritası sağlayıcıları için iyileştirilmiş bir arama yöntemi sağlar.

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parametreler

node
SiteMapNode

SiteMapNode ve relativeDepthFromWalkupiçin walkupLevels bir başvuru noktası işlevi gören .

walkupLevels
Int32

İstenen üst düğüm alınırken geçilmesi gereken üst düğüm düzeylerinin sayısı.

relativeDepthFromWalkup
Int32

Hedef üst düğümden alınacak alt düğüm düzeylerinin sayısı.

Döndürülenler

SiteMapNode Geçerli veya üst nodeöğe bulunamazsa veya geçerli kullanıcı için döndürülemezse , öğesinin nullbir üst SiteMapNode öğesini temsil eder.

Özel durumlar

veya relativeDepthFromWalkup için walkupLevels belirtilen değer 0'dan küçük.

node, null değeridir.

Açıklamalar

sınıfının varsayılan uygulaması yönteminin SiteMapProvider iyileştirilmiş olmayan bir uygulamasını GetParentNodeRelativeToNodeAndHintDownFromParent sağlar ve yöntemlerini çağırır HintAncestorNodesHintNeighborhoodNodes ; ancak site haritası sağlayıcıları yöntemi geçersiz kılabilir GetParentNodeRelativeToNodeAndHintDownFromParent ve üst düğümünü döndürmek ve diğer SiteMapNode nesnelerin iyileştirilmiş bir aramasını gerçekleştirmek için özel önbelleğe alma mekanizmaları kullanan iyileştirilmiş bir uygulama sağlayabilir. GetParentNodeRelativeToNodeAndHintDownFromParent yöntemi yöntemine GetParentNodeRelativeToCurrentNodeAndHintDownFromParent çok benzer.

walkupLevels parametresi, hedef düğüm alınırken kaç üst ve üst düğüm düzeyinin geçirileceğini belirtmek için kullanılır. İstenenden daha az düzey varsa, null döndürülür. downLevel parametresi, hedef üst düğümden kaç alt düğüm düzeyinin alınacağını belirtmek için kullanılır. Tercih edilirse, ve özellikleri kullanılarak, atası ve alt düğümleri yöntemi tarafından GetParentNodeRelativeToNodeAndHintDownFromParent döndürülen öğesine ChildNodesParentNode bağlanabilirSiteMapNode. parametresi tarafından upLevel belirtilenden daha az üst düğüm düzeyi varsa, null döndürülür. Kullanılabilir alt düğüm düzeylerinin sayısının parametresi tarafından belirtilen değerden daha az olduğu durumun nasıl işlendiğine karar vermek sağlayıcı uygulayıcısına downLevel kalır.

Şunlara uygulanır

Ayrıca bkz.