XmlSiteMapProvider.FindSiteMapNode(String) Methode

Definitie

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.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Parameters

rawUrl
String

Een URL die de pagina identificeert waarvoor een SiteMapNode.

Retouren

Een SiteMapNode die de pagina vertegenwoordigt die wordt geïdentificeerd door rawURL.

Uitzonderingen

Een onderliggende provider die is gekoppeld aan de huidige siteoverzichtprovider heeft een knooppunt geretourneerd dat niet geldig is.

Opmerkingen

Het XmlSiteMapProvider object overschrijft de FindSiteMapNode methode om ervoor te zorgen dat gekoppelde onderliggende providers naar het knooppunt worden gezocht als de implementatie van de basisklasse geen knooppunt retourneert voor de opgegeven URL.

De rawUrl parameter moet een absoluut virtueel pad of een toepassings-relatief pad zijn, afhankelijk van hoe deze is opgegeven in het XML-siteoverzichtsgegevensbestand.

De XmlSiteMapProvider klasse en klassen die hiervan zijn afgeleid, gebruiken de URL van een SiteMapNode object als sleutel in de verschillende verzamelingen die door de klasse worden onderhouden. Daarom moeten deze URL's uniek zijn binnen het bereik van het siteoverzicht. Als de URL niet wordt gevonden in de directe siteoverzichtgegevens die worden beheerd door de XmlSiteMapProvidersitetoewijzing, wordt de FindSiteMapNode url aangeroepen op elke onderliggende provider die eraan is gekoppeld via het kenmerk van de provider siteoverzichtknooppunten.

De FindSiteMapNode methode roept indirect de BuildSiteMap methode aan om het knooppunt op het hoogste niveau in de siteoverzicht op te halen. Eventuele uitzonderingen voor de BuildSiteMap methode kunnen daarom ook optreden bij het aanroepen van de FindSiteMapNode methode.

Van toepassing op

Zie ook