XmlSiteMapProvider.FindSiteMapNode(String) Methode

Definition

Ruft ein SiteMapNode-Objekt ab, das die Seite an der angegebenen URL darstellt.Retrieves a SiteMapNode object that represents the page at the specified URL.

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.A URL that identifies the page for which to retrieve a SiteMapNode.

Gibt zurück

Ein SiteMapNode, der die von rawURL angegebene Seite darstellt.A SiteMapNode that represents the page identified by rawURL.

Ausnahmen

Ein untergeordneter, mit dem aktuellen Siteübersichtsanbieter verknüpfter Anbieter hat einen ungültigen Knoten zurückgegeben.A child provider linked to the current site map provider returned a node that is not valid.

Hinweise

Das XmlSiteMapProvider -Objekt überschreibt FindSiteMapNode 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 URL zurückgibt.The XmlSiteMapProvider object overrides the FindSiteMapNode method to ensure that any linked child providers are searched for the node if the implementation of the base class does not return a node for the specified URL.

Der rawUrl -Parameter muss entweder ein absoluter virtueller Pfad oder ein Anwendungs relativer Pfad sein, je nachdem, wie er in der XML Site Map-Datendatei angegeben wird.The rawUrl parameter should be either an absolute virtual path or an application-relative path, depending on how it is specified in the XML site map data file.

Die XmlSiteMapProvider Klasse und die Klassen, die von ihr abgeleitet werden, verwenden die SiteMapNode URL eines-Objekts als Schlüssel in den verschiedenen Auflistungen, die von der-Klasse verwaltet werden.The XmlSiteMapProvider class and classes that are derived from it use the URL of a SiteMapNode object as a key in the various collections that the class maintains. Daher müssen diese URLs innerhalb des Bereichs der Site Übersicht eindeutig sein.Therefore, these URLs must be unique within the scope of the site map. Wenn die URL nicht innerhalb der direkt von XmlSiteMapProviderverwalteten Site Übersichts Daten gefunden wird, ruft Sie den FindSiteMapNode für jeden untergeordneten Anbieter auf, der über das provider -Attribut der Site Übersichts Knoten mit diesem verknüpft ist.If the URL is not found within the immediate site map data that is managed by the XmlSiteMapProvider, it calls the FindSiteMapNode on each child provider that is linked to it through the provider attribute of its site map nodes.

Die FindSiteMapNode -Methode ruft indirekt BuildSiteMap die-Methode auf, um den Knoten der obersten Ebene in der Site Übersicht abzurufen.The FindSiteMapNode method indirectly calls the BuildSiteMap method to retrieve the top-level node in the site map. Daher können alle Ausnahmen, die für die BuildSiteMap -Methode auftreten, auch auftreten, FindSiteMapNode wenn die-Methode aufgerufen wird.Therefore, any exceptions that occur for the BuildSiteMap method can also occur when calling the FindSiteMapNode method.

Gilt für:

Siehe auch