SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web
Bütünleştirilmiş Kod:
System.Web.dll

ş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

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

Özel durumlar

ArgumentOutOfRangeException

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

Şunlara uygulanır

Ayrıca bkz.