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 haritası 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

Elde edilen atası site haritası düğüm nesillerinin sayısı. -1 değeri, sağlayıcı tarafından tüm üst değerlerin alınıp önbelleğe alınabileceğini gösterir.

Döndürülenler

SiteMapNode

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öntemi geçersiz kılabilir GetCurrentNodeAndHintAncestorNodes ve hem geçerli SiteMapNodehem de ü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 nesnesineSiteMapNode, ö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ük oluşturur veya hiç ek yük oluşturmaz.

Şunlara uygulanır

Ayrıca bkz.