StaticSiteMapProvider.FindSiteMapNode(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een SiteMapNode object opgehaald dat de pagina op de opgegeven URL vertegenwoordigt.
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 SiteMapNodeParameters
- rawUrl
- String
Een URL die de pagina identificeert waarvoor een SiteMapNode.
Retouren
Een SiteMapNode die de pagina vertegenwoordigt die wordt geïdentificeerd door rawURL; anders, nullals er geen overeenkomend siteoverzichtsknooppunt wordt gevonden.
Uitzonderingen
rawURL is null.
Opmerkingen
De opgegeven URL is doorgaans een virtuele of absolute URL. Het kan ook een URL zijn die gebruikmaakt van ASP.NET toepassings-relatieve syntaxis, zoals "~/apprelativedirectory". De StaticSiteMapProvider klasse normaliseert automatisch de onbewerkte URL's van de toepassing naar een absoluut virtueel pad.
Het XmlSiteMapProvider-object, dat is afgeleid van de StaticSiteMapProvider en de standaardsiteoverzichtprovider is voor ASP.NET, gebruikt standaard de eigenschap Url van een SiteMapNode-object als zoeksleutel in de interne verzamelingen. Als de eigenschap van de UrlSiteMapNode set is ingesteld, moet deze uniek zijn binnen het bereik van de siteoverzichtprovider. De FindSiteMapNode methode probeert siteoverzichtknooppunten op te halen op basis van hun Url. Anders kunt u de Key eigenschap en de bijbehorende FindSiteMapNodeFromKey methode gebruiken om siteoverzichtknooppunten op te halen. Als er geen Url of Key is opgegeven, genereert de siteoverzichtprovider automatisch een Key eigenschap om de siteoverzichtknooppunten bij te houden.
Notities voor overnemers
Wanneer u de FindSiteMapNode(String) methode in een afgeleide klasse overschrijft, moet u ervoor zorgen dat u de URL's normaliseert van de SiteMapNode objecten die u toevoegt aan uw siteoverzichtprovider, zodat de methode een siteoverzichtknooppunt kan ophalen, ongeacht of de FindSiteMapNode(String) URL voor het siteoverzichtknooppunt wordt opgegeven als een absoluut virtueel pad of een relatief toepassingspad.
Het gedrag van beveiligingsbeperkingen is opgenomen in de SiteMapProvider en StaticSiteMapProvider klasse-implementaties. Voor het beperken van beveiliging in afgeleide klassen moet u echter de Roles eigenschap instellen van objecten SiteMapNode die u maakt tijdens het bouwen van een siteoverzichtprovider wanneer u de BuildSiteMap() methode overschrijft.
