SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, 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 site haritası düğümlerini geçerli düğümün yakınında getirirken site haritası sağlayıcıları için iyileştirilmiş bir arama yöntemi sağlar.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);
abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode
Parametreler
- upLevel
- Int32
Getirilecek ata nesillerinin SiteMapNode sayısı. 0, hiçbir üst düğümün alındığını ve -1 tüm üst düğümlerin sağlayıcı tarafından alınıp önbelleğe alınabileceğini belirtir.
- downLevel
- Int32
Getirilecek çocuk SiteMapNode nesillerinin sayısı. 0 alt düğümlerin alınıp alınılmadığını, -1 ise tüm alt düğümlerin sağlayıcı tarafından alınıp önbelleğe alınabileceğini belirtir.
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
veya downLevel
-1'den küçüktür.
Açıklamalar
Yöntemin GetCurrentNodeAndHintNeighborhoodNodes varsayılan uygulaması özelliğini döndürürCurrentNode; ancak, site haritası sağlayıcıları yöntemini geçersiz kılabilir GetCurrentNodeAndHintNeighborhoodNodes ve geçerli nesnenin yanı sıra geçerli nesnesinin yanı sıra SiteMapNode geçerli SiteMapNodeSiteMapNodeöğesine yakın olan nesneleri döndürmek için özel önbelleğe alma mekanizmaları kullanan iyileştirilmiş bir uygulama sağlayabilir.
upLevel
parametresi, üst ve üst düğüm düzeylerinin ve bunların anlık alt öğelerinin alınıp önbelleğe alınacağını belirtmek için kullanılır.
downLevel
parametresi, geçerli SiteMapNode düğümden kaç alt düğüm düzeyinin alınacağını belirtmek için kullanılır. Tercih edilirse, ata ve alt düğümler tarafından döndürülen öğesine bağlanabilir SiteMapNode
GetCurrentNodeAndHintNeighborhoodNodes yöntemini ve özelliklerini kullanarak ParentNodeChildNodes . veya downLevel
tarafından upLevel
belirtilenden daha az üst veya alt düğüm düzeyi varsa, yalnızca kullanılabilir olanlar alınır.
XmlSiteMapProvider ASP.NET için varsayılan site haritası sağlayıcısı olan sınıfı, tüm site haritasını 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.