StaticSiteMapProvider.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 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.