SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan metode pencarian yang dioptimalkan untuk penyedia peta situs saat mengambil simpul untuk halaman yang saat ini diminta dan mengambil simpul peta situs induk dan leluhur untuk halaman saat ini.
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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParameter
- upLevel
- Int32
Jumlah pembuatan simpul peta situs leluhur untuk didapatkan. Nilai -1 menunjukkan bahwa semua leluhur mungkin diambil dan di-cache oleh penyedia.
Mengembalikan
SiteMapNode Yang mewakili halaman yang saat ini diminta; jika tidak, null, jika SiteMapNode tidak ditemukan atau tidak dapat dikembalikan untuk pengguna saat ini.
Pengecualian
upLevel kurang dari -1.
Keterangan
Implementasi GetCurrentNodeAndHintAncestorNodes default metode mengembalikan CurrentNode properti; namun, penyedia peta situs dapat mengambil alih GetCurrentNodeAndHintAncestorNodes metode dan memberikan implementasi yang dioptimalkan yang menggunakan mekanisme penembolokan kustom untuk mengembalikan simpul induk dan leluhur induk saat ini SiteMapNode.
Parameter upLevel digunakan untuk menentukan berapa banyak tingkat simpul induk dan leluhur yang akan diambil. Jika disukai, simpul induk dan leluhur dapat ditautkan ke SiteMapNode objek yang dikembalikan oleh GetCurrentNodeAndHintAncestorNodes metode , menggunakan ParentNode properti .
Kelas XmlSiteMapProvider , yang merupakan penyedia peta situs default untuk ASP.NET, menyimpan seluruh peta situs dalam memori, yang menghasilkan sedikit atau tanpa overhead saat mengkueri XmlSiteMapProvider untuk objek tertentu SiteMapNode .
