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 angibt, für die ein SiteMapNode abgerufen werden soll.
Gibt zurück
Ein SiteMapNode, der die von rawURL angegebene Seite darstellt.
Ausnahmen
Ein untergeordneter, mit dem aktuellen Siteübersichtsanbieter verknüpfter Anbieter hat einen ungültigen Knoten zurückgegeben.
Hinweise
Das -Objekt überschreibt die -Methode, um sicherzustellen, dass alle verknüpften untergeordneten Anbieter nach dem Knoten durchsucht werden, wenn die Implementierung der Basisklasse keinen Knoten für die angegebene XmlSiteMapProvider FindSiteMapNode URL zurück gibt.
Der Parameter sollte entweder ein absoluter virtueller Pfad oder ein anwendungs relativer Pfad sein, je nachdem, wie er in der XML-Siteübersichtsdatendatei rawUrl angegeben wird.
Die Klasse und die Klassen, die davon abgeleitet werden, verwenden die URL eines -Objekts als Schlüssel in den verschiedenen Auflistungen, die XmlSiteMapProvider SiteMapNode von der -Klasse verwaltet werden. Daher müssen diese URLs innerhalb des Bereichs der Siteübersicht eindeutig sein. Wenn die URL nicht in den direkt vom verwalteten Siteübersichtsdaten gefunden wird, ruft sie auf jedem untergeordneten Anbieter auf, der über das -Attribut seiner Siteübersichtsknoten mit ihr XmlSiteMapProvider FindSiteMapNode verknüpft provider ist.
Die FindSiteMapNode -Methode ruft indirekt die BuildSiteMap -Methode auf, um den Knoten der obersten Ebene in der Siteübersicht abzurufen. Daher können alle Ausnahmen, die für die -Methode BuildSiteMap auftreten, auch beim Aufrufen der -Methode FindSiteMapNode auftreten.