StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Methode

Definition

Ruft ein SiteMapNode-Objekt auf Grundlage eines angegebenen Schlüssels ab.Retrieves a SiteMapNode object based on a specified key.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parameter

key
String

Ein Suchschlüssel, mit dem ein SiteMapNode erstellt wird.A lookup key with which a SiteMapNode is created.

Gibt zurück

Ein SiteMapNode, der die von key identifizierte Seite darstellt. Andernfalls null, wenn Einschränkungen aus Sicherheitsgründen aktiviert sind und der Siteübersichtsknoten dem aktuellen Benutzer nicht angezeigt werden kann bzw. der Siteübersichtsknoten von key in der Siteübersichtsknotenauflistung nicht gefunden wird.A SiteMapNode that represents the page identified by key; otherwise, null, if security trimming is enabled and the site map node cannot be shown to the current user or the site map node is not found in the site map node collection by key.

Hinweise

Die FindSiteMapNodeFromKey -Methode ruft einen Site Übersichts Knoten von einem internen Hashtable -Objekt ab key, das auf basiert.The FindSiteMapNodeFromKey method retrieves a site map node from an internal Hashtable object based on key.

Das XmlSiteMapProvider -Objekt, das von der StaticSiteMapProvider -Klasse abgeleitet ist und der Standard-Site Übersichts Anbieter für ASP.net ist Url , SiteMapNode verwendet standardmäßig die-Eigenschaft eines-Objekts als Suchschlüssel in seinen internen Auflistungen.The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider class 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 SiteMapNode von 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 Urlabzurufen.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.

Der StaticSiteMapProvider verfügt über eine Standard Implementierung, die Instanzen SiteMapNode der-Klasse basierend auf dem key -Parameter sucht.The StaticSiteMapProvider has a default implementation that looks up instances of the SiteMapNode class based on the key parameter. Wenn ein sitemapanbieterimplementierer AddNode die-Methode StaticSiteMapProvider verwendet hat, wird von bereits ein Verweis SiteMapNode auf die einzelnen Daten auf Grundlage SiteMapNode.Key des Werts der-Eigenschaft gespeichert.If a site map provider implementer used the AddNode method, the StaticSiteMapProvider already will have stored a reference to each SiteMapNode based on the value of the SiteMapNode.Key property. Standardmäßig XmlSiteMapProvider generiert GUIDs für Instanzen SiteMapNode der-Klasse, die nicht über einen Wert für die SiteMapNode.Url -Eigenschaft verfügen.By default, the XmlSiteMapProvider generates GUIDs for instances of the SiteMapNode class that do not have a value for the SiteMapNode.Url property. Die Implementierer von benutzerdefinierten Site Übersichts Anbietern müssen einen eigenen Mechanismus zum Erstellen SiteMapNode.Key SiteMapNode eindeutiger Werte für die-Eigenschaft bereitstellen, wenn eine Instanz der-Klasse über keinen SiteMapNode.Url Wert für die-Eigenschaft verfügt.Custom site map provider implementers must provide their own mechanism for generating unique values of the SiteMapNode.Key property in the event that an instance of the SiteMapNode class does not have a value for the SiteMapNode.Url property.

Die SiteMapProvider - XmlSiteMapProvider und-Klassen, bei denen es sich um die Standard Implementierung des Site Map-Anbieters für SiteMapNode ASP.net handelt, verwenden die URL eines-Objekts als Schlüssel in den verschiedenen Auflistungen, die die-Klassen verwalten.The SiteMapProvider and XmlSiteMapProvider classes, which are the default site map provider implementation for ASP.NET, use the URL of a SiteMapNode object as a key in the various collections that the classes maintain.

Gilt für:

Siehe auch