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

SiteMapNode

Ein SiteMapNode, der die Seite darstellt, die durch rawURL identifiziert wird. Andernfalls null, wenn kein entsprechender Siteübersichtsknoten gefunden wird.A SiteMapNode that represents the page identified by rawURL; otherwise, null, if no corresponding site map node is found.

Ausnahmen

rawURL ist null.rawURL is null.

Hinweise

Die angegebene URL ist in der Regel ein virtueller oder absolute URL.The provided URL is typically a virtual or absolute URL. Es kann sich auch um eine URL handeln, die die Anwendungs relative Syntax ASP.NET verwendet, z "~/apprelativedirectory" . b..It can also be a URL that uses ASP.NET application-relative syntax, such as "~/apprelativedirectory". Die StaticSiteMapProvider -Klasse normalisiert Anwendungs relative Rohdaten-URLs automatisch in einen absoluten virtuellen Pfad.The StaticSiteMapProvider class automatically normalizes application-relative raw URLs to an absolute virtual path.

Das XmlSiteMapProvider -Objekt, das von abgeleitet ist StaticSiteMapProvider und der Standard-Site Übersichts Anbieter für ASP.net, verwendet die- Url Eigenschaft eines- SiteMapNode Objekts standardmäßig als Suchschlüssel in seinen internen Auflistungen.The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider and is the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. Wenn die- Url Eigenschaft von SiteMapNode festgelegt ist, muss Sie innerhalb des Bereichs des Site Übersichts Anbieters eindeutig sein.If the Url property of the SiteMapNode is set, it must be unique within the scope of the site map provider. Die- FindSiteMapNode Methode versucht, Site Übersichts Knoten basierend auf Ihren abzurufen Url .The FindSiteMapNode method attempts to retrieve site map nodes based on their Url. Andernfalls können Sie die Key -Eigenschaft und die entsprechende- FindSiteMapNodeFromKey Methode zum Abrufen von Site Übersichts Knoten verwenden.Otherwise, you can use the Key property and the corresponding FindSiteMapNodeFromKey method to retrieve site map nodes. Wenn weder Url noch Key angegeben wird, generiert der Site Übersichts Anbieter automatisch eine Key Eigenschaft zum Nachverfolgen der Site Übersichts Knoten.If no Url or Key is specified, the site map provider automatically generates a Key property to track the site map nodes.

Hinweise für Vererber

Wenn Sie die FindSiteMapNode(String) Methode in einer abgeleiteten Klasse überschreiben, stellen Sie sicher, dass Sie die URLs der Objekte, die SiteMapNode Sie Ihrem Site Übersichts Anbieter hinzufügen, normalisieren, damit die FindSiteMapNode(String) Methode einen Site Übersichts Knoten abrufen kann, unabhängig davon, ob die URL für den Site Übersichts Knoten als absoluter virtueller Pfad oder als relativer Anwendungspfad angegeben wird.When overriding the FindSiteMapNode(String) method in a derived class, be sure to normalize the URLs of the SiteMapNode objects that you add to your site map provider, so that the FindSiteMapNode(String) method can retrieve a site map node regardless of whether URL for the site map node is supplied as an absolute virtual path or an application relative path.

Das sicherheitseinschränkungs Verhalten ist in den SiteMapProvider -und- StaticSiteMapProvider Klassen Implementierungen enthalten.Security trimming behavior is included in the SiteMapProvider and StaticSiteMapProvider class implementations. Damit die Sicherheits Kürzung in abgeleiteten Klassen funktioniert, müssen Sie jedoch die-Eigenschaft aller Objekte festlegen, die Roles SiteMapNode Sie während der Erstellung eines Site Übersichts Anbieters erstellen, wenn Sie die-Methode überschreiben BuildSiteMap() .However, for security trimming to function in derived classes, you must set the Roles property of any SiteMapNode objects that you create while building a site map provider when you override the BuildSiteMap() method.

Gilt für:

Weitere Informationen