Freigeben über


XmlSiteMapProvider.FindSiteMapNode(String) Methode

Definition

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

Parameter

rawUrl
String

Eine URL, die die Seite angibt, für die ein SiteMapNode abgerufen werden soll.

Gibt zurück

SiteMapNode

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.

Gilt für

Siehe auch