StaticSiteMapProvider.FindSiteMapNode(String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar ett SiteMapNode objekt som representerar sidan på den angivna URL:en.
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 SiteMapNodeParametrar
- rawUrl
- String
En URL som identifierar sidan som du vill hämta en SiteMapNode.
Returer
En SiteMapNode som representerar sidan som identifieras av rawURL, annars , nullom ingen motsvarande platskartanod hittas.
Undantag
rawURL är null.
Kommentarer
Den angivna URL:en är vanligtvis en virtuell eller absolut URL. Det kan också vara en URL som använder ASP.NET programrelativ syntax, till exempel "~/apprelativedirectory". Klassen StaticSiteMapProvider normaliserar automatiskt programrelativa rå-URL:er till en absolut virtuell sökväg.
Objektet XmlSiteMapProvider, som härleds från StaticSiteMapProvider och är standardprovidern för webbplatsöversikt för ASP.NET, använder egenskapen Url för ett SiteMapNode-objekt som en uppslagsnyckel i sina interna samlingar som standard. Om egenskapen Url för SiteMapNode har angetts måste den vara unik inom webbplatsöversiktsproviderns omfång. Metoden FindSiteMapNode försöker hämta platsmappningsnoder baserat på deras Url. Annars kan du använda Key egenskapen och motsvarande FindSiteMapNodeFromKey metod för att hämta platsmappningsnoder. Om inget Url eller Key anges genererar webbplatsöversiktsprovidern automatiskt en Key egenskap för att spåra platsöversiktsnoderna.
Anteckningar till arvingar
När du åsidosätter FindSiteMapNode(String) metoden i en härledd klass bör du normalisera URL:erna för de SiteMapNode objekt som du lägger till i webbplatsöversiktsprovidern, så att FindSiteMapNode(String) metoden kan hämta en platsöversiktsnod oavsett om URL:en för platskartenoden anges som en absolut virtuell sökväg eller en relativ sökväg för programmet.
Beteendet för säkerhetstrimning ingår i implementeringarna SiteMapProvider och StaticSiteMapProvider -klassen. Men för att säkerhetstrimning ska fungera i härledda klasser måste du ange Roles egenskapen för alla SiteMapNode objekt som du skapar när du skapar en webbplatsöversiktsprovider när du åsidosätter BuildSiteMap() metoden.
