Freigeben über


StaticSiteMapProvider.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 Seite darstellt, die durch rawURL identifiziert wird. Andernfalls null, wenn kein entsprechender Siteübersichtsknoten gefunden wird.

Ausnahmen

rawURL ist null.

Hinweise

Die bereitgestellte URL ist in der Regel eine virtuelle oder absolute URL. Es kann auch eine URL sein, die ASP.NET anwendungsrelative Syntax verwendet, z"~/apprelativedirectory". B. . Die StaticSiteMapProvider Klasse normalisiert automatisch anwendungsrelative unformatierte URLs auf einen absoluten virtuellen Pfad.

Das XmlSiteMapProvider Objekt, das vom StaticSiteMapProvider Standardanbieter für die Websitezuordnung für ASP.NET abgeleitet wird, verwendet standardmäßig die Url Eigenschaft eines SiteMapNode Objekts als Nachschlageschlüssel in seinen internen Auflistungen. Wenn die Url Eigenschaft des SiteMapNode Satzes festgelegt ist, muss sie innerhalb des Bereichs des Websitezuordnungsanbieters eindeutig sein. Die FindSiteMapNode Methode versucht, Standortzuordnungsknoten basierend auf deren Url. Andernfalls können Sie die Key Eigenschaft und die entsprechende FindSiteMapNodeFromKey Methode verwenden, um Standortzuordnungsknoten abzurufen. Wenn kein Url oder Key angegeben wird, generiert der Websitezuordnungsanbieter automatisch eine Key Eigenschaft, um die Knoten der Websitezuordnung nachzuverfolgen.

Hinweise für Vererber

Achten Sie beim Außerkraftsetzen der FindSiteMapNode(String) Methode in einer abgeleiteten Klasse darauf, die URLs der Objekte zu normalisieren, die SiteMapNode Sie ihrem Websitezuordnungsanbieter hinzufügen, sodass die FindSiteMapNode(String) Methode einen Websitezuordnungsknoten abrufen kann, unabhängig davon, ob die URL für den Websitezuordnungsknoten als absoluter virtueller Pfad oder ein anwendungsrelativer Pfad bereitgestellt wird.

Das Verhalten der Sicherheitskürzung ist in den SiteMapProvider Implementierungen und StaticSiteMapProvider Klassen enthalten. Um jedoch in abgeleiteten Klassen zu funktionieren, müssen Sie die Eigenschaft aller SiteMapNode Objekte festlegen, die Roles Sie beim Erstellen eines Websitezuordnungsanbieters erstellen, wenn Sie die BuildSiteMap() Methode außer Kraft setzen.

Gilt für

Siehe auch