XmlSiteMapProvider.FindSiteMapNode(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein SiteMapNode Objekt ab, das die Seite an der angegebenen URL darstellt.
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
Eine URL, die die Seite identifiziert, für die ein Abgerufen werden SiteMapNodesoll.
Gibt zurück
Ein SiteMapNode Wert, der die von rawURLder Seite identifizierte Seite darstellt.
Ausnahmen
Ein untergeordneter Anbieter, der mit dem aktuellen Websitezuordnungsanbieter verknüpft ist, hat einen ungültigen Knoten zurückgegeben.
Hinweise
Das XmlSiteMapProvider Objekt überschreibt die FindSiteMapNode Methode, um sicherzustellen, dass alle verknüpften untergeordneten Anbieter nach dem Knoten gesucht werden, wenn die Implementierung der Basisklasse keinen Knoten für die angegebene URL zurückgibt.
Der rawUrl Parameter sollte entweder ein absoluter virtueller Pfad oder ein anwendungsrelativer Pfad sein, je nachdem, wie er in der XML-Websitezuordnungsdatendatei angegeben wird.
Die XmlSiteMapProvider von ihr abgeleitete Klasse und Klassen verwenden die URL eines SiteMapNode Objekts als Schlüssel in den verschiedenen Auflistungen, die die Klasse verwaltet. Daher müssen diese URLs innerhalb des Bereichs der Websiteübersicht eindeutig sein. Wenn die URL nicht innerhalb der unmittelbaren Websiteübersichtsdaten gefunden wird, die von dem XmlSiteMapProviderverwaltet werden, ruft sie die FindSiteMapNode untergeordneten Anbieter auf, die über das provider Attribut ihrer Websitezuordnungsknoten mit ihm verknüpft sind.
Die FindSiteMapNode Methode ruft die BuildSiteMap Methode indirekt auf, um den Knoten der obersten Ebene in der Websitezuordnung abzurufen. Daher können alle Ausnahmen, die für die BuildSiteMap Methode auftreten, auch beim Aufrufen der FindSiteMapNode Methode auftreten.
