Aracılığıyla paylaş


SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Yöntem

Tanım

Şu anda istenen sayfanın düğümünü alırken ve geçerli sayfa için üst ve üst site eşleme düğümlerini getirirken site haritası sağlayıcıları için iyileştirilmiş bir arama yöntemi sağlar.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes(int upLevel);
abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

Parametreler

upLevel
Int32

Alınacak ata site haritası düğüm nesillerinin sayısı. -1 değeri, sağlayıcı tarafından tüm ataların alınıp önbelleğe alınabileceğini gösterir.

Döndürülenler

SiteMapNode şu anda istenen sayfayı temsil eden bir; aksi takdirde , nullbulunamazsa veya geçerli kullanıcı için döndürülemezseSiteMapNode.

Özel durumlar

upLevel -1'den küçüktür.

Açıklamalar

Yöntemin GetCurrentNodeAndHintAncestorNodes varsayılan uygulaması özelliğini döndürür CurrentNode ; ancak site haritası sağlayıcıları yöntemini geçersiz kılabilir GetCurrentNodeAndHintAncestorNodes ve geçerli SiteMapNodeöğesini ve üst düğümlerin üst ve üst düğümlerini döndürmek için özel önbelleğe alma mekanizmaları kullanan iyileştirilmiş bir uygulama sağlayabilir.

upLevel parametresi, kaç üst ve üst düğüm düzeyinin alınacağını belirtmek için kullanılır. Tercih edilirse, üst ve üst düğümler, yöntemi tarafından GetCurrentNodeAndHintAncestorNodes döndürülen nesneyeSiteMapNode, özelliği kullanılarak ParentNode bağlanabilir.

XmlSiteMapProvider ASP.NET için varsayılan site haritası sağlayıcısı olan sınıfı, tüm site eşlemesini bellekte önbelleğe alır ve bu da belirli SiteMapNode nesneler için sorgulanırken XmlSiteMapProvider çok az ek yüke neden olur veya hiç ek yük oluşturmaz.

Şunlara uygulanır

Ayrıca bkz.