XmlSiteMapProvider.FindSiteMapNodeFromKey(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 op basis van een opgegeven sleutel.
public:
override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);public override System.Web.SiteMapNode FindSiteMapNodeFromKey(string key);override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParameters
- key
- String
Een zoeksleutel waarmee een SiteMapNode.
Retouren
Een SiteMapNode die de pagina vertegenwoordigt die wordt geïdentificeerd door key; anders, nullals beveiligingsbeperkingen zijn ingeschakeld en het knooppunt niet kan worden weergegeven aan de huidige gebruiker of het knooppunt niet wordt gevonden in key de knooppuntverzameling.
Uitzonderingen
Een onderliggende provider die is gekoppeld aan de huidige siteoverzichtprovider heeft een knooppunt geretourneerd dat niet geldig is.
Opmerkingen
De XmlSiteMapProvider klasse overschrijft de FindSiteMapNodeFromKey methode om ervoor te zorgen dat gekoppelde onderliggende providers naar het knooppunt worden gezocht als de implementatie voor de basisklasse geen knooppunt retourneert.key
Het XmlSiteMapProvider-object, afgeleid van de klasse StaticSiteMapProvider en de standaardsiteoverzichtprovider 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 provider. Als er geen Url is opgegeven, XmlSiteMapProvider wordt er automatisch een Key gegenereerd om de knooppunten bij te houden.
De FindSiteMapNodeFromKey methode kan de BuildSiteMap methode aanroepen voor alle onderliggende providers die zijn gekoppeld aan de huidige provider. Daarom kunnen de uitzonderingen die in de BuildSiteMap methode worden beschreven, worden gegenereerd.
