StaticSiteMapProvider.FindSiteMapNode(String) 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.
SiteMapNode Mengambil objek yang mewakili halaman pada URL yang ditentukan.
public:
override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);public override System.Web.SiteMapNode FindSiteMapNode(string rawUrl);override this.FindSiteMapNode : string -> System.Web.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNodeParameter
- rawUrl
- String
URL yang mengidentifikasi halaman untuk mengambil SiteMapNode.
Mengembalikan
SiteMapNode Yang mewakili halaman yang diidentifikasi oleh rawURL; jika tidak, null, jika tidak ada simpul peta situs yang sesuai yang ditemukan.
Pengecualian
rawURL adalah null.
Keterangan
URL yang disediakan biasanya adalah URL virtual atau absolut. Ini juga bisa menjadi URL yang menggunakan sintaksis relatif aplikasi ASP.NET, seperti "~/apprelativedirectory". Kelas StaticSiteMapProvider secara otomatis menormalkan URL mentah relatif aplikasi ke jalur virtual absolut.
Objek XmlSiteMapProvider , yang berasal dari StaticSiteMapProvider dan merupakan penyedia peta situs default untuk ASP.NET, menggunakan Url properti SiteMapNode objek sebagai kunci pencarian dalam koleksi internalnya, secara default. Url Jika properti diatur, properti SiteMapNode harus unik dalam lingkup penyedia peta situs. Metode ini FindSiteMapNode mencoba mengambil simpul peta situs berdasarkan Url. Jika tidak, Anda dapat menggunakan Key properti dan metode yang FindSiteMapNodeFromKey sesuai untuk mengambil simpul peta situs. Jika tidak ada Url atau Key ditentukan, penyedia peta situs secara otomatis menghasilkan Key properti untuk melacak simpul peta situs.
Catatan Bagi Inheritor
Saat mengambil FindSiteMapNode(String) alih metode di kelas turunan, pastikan untuk menormalkan URL SiteMapNode objek yang Anda tambahkan ke penyedia peta situs Anda, sehingga FindSiteMapNode(String) metode dapat mengambil simpul peta situs terlepas dari apakah URL untuk simpul peta situs disediakan sebagai jalur virtual absolut atau jalur relatif aplikasi.
Perilaku pemangkasan keamanan disertakan SiteMapProvider dalam implementasi kelas dan StaticSiteMapProvider . Namun, agar pemangkasan keamanan berfungsi di kelas turunan, Anda harus mengatur Roles properti objek apa pun SiteMapNode yang Anda buat saat membangun penyedia peta situs saat mengambil BuildSiteMap() alih metode.
