StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Ruft ein SiteMapNode-Objekt auf Grundlage eines angegebenen Schlüssels ab.

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.

Gibt zurück

SiteMapNode

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.

Hinweise

Die FindSiteMapNodeFromKey -Methode ruft einen Siteübersichtsknoten aus einem internen Hashtable Objekt ab, das auf basiert key.

Das XmlSiteMapProvider Objekt, das von der StaticSiteMapProvider -Klasse abgeleitet ist und der Standardanbieter für die Siteübersicht für ASP.NET ist, verwendet standardmäßig die Url Eigenschaft eines SiteMapNode Objekts als Nachschlageschlüssel in seinen internen Auflistungen. Wenn die Url -Eigenschaft von SiteMapNode festgelegt ist, muss sie innerhalb des Bereichs des Siteübersichtsanbieters eindeutig sein. Die FindSiteMapNode -Methode versucht, Siteübersichtsknoten basierend auf ihren Urlabzurufen. Andernfalls können Sie die Key -Eigenschaft und die entsprechende FindSiteMapNodeFromKey Methode verwenden, um Siteübersichtsknoten abzurufen.

Verfügt StaticSiteMapProvider über eine Standardimplementierung, die Instanzen der SiteMapNode -Klasse basierend auf dem key -Parameter sucht. Wenn ein Site map provider implementer die AddNode -Methode verwendet hat, hat die StaticSiteMapProvider bereits einen Verweis auf jede SiteMapNode gespeichert, basierend auf dem Wert der SiteMapNode.Key -Eigenschaft. Standardmäßig generiert die XmlSiteMapProvider GUIDs für Instanzen der -Klasse, die SiteMapNode keinen Wert für die SiteMapNode.Url -Eigenschaft haben. Benutzerdefinierte Siteübersichtsanbieterimplementierungsanbieter müssen einen eigenen Mechanismus zum Generieren eindeutiger Werte der SiteMapNode.Key Eigenschaft bereitstellen, falls eine Instanz der SiteMapNode -Klasse keinen Wert für die SiteMapNode.Url -Eigenschaft aufweist.

Die SiteMapProvider Klassen und XmlSiteMapProvider , bei denen es sich um die Standardimplementierung des Siteübersichtsanbieters für ASP.NET handelt, verwenden die URL eines SiteMapNode Objekts als Schlüssel in den verschiedenen Auflistungen, die von den Klassen verwaltet werden.

Weitere Informationen

• FindSiteMapNode