SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
ş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 şu anda istenen sayfayı temsil eden bir; aksi takdirde , null
bulunamazsa 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.