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 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.