Freigeben über


SiteMapProvider.FindSiteMapNodeFromKey(String) Methode

Definition

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

public:
 virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overridable 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 angegebene Seite darstellt. Andernfalls null, wenn kein entsprechender SiteMapNode gefunden wird oder wenn Einschränkungen aus Sicherheitsgründen aktiviert sind und der SiteMapNode für den aktuellen Benutzer nicht zurückgegeben werden kann. Der Standardwert ist null.

Hinweise

Die SiteMapProvider Implementierung gibt in allen Fällen zurück null . Klassen, die von der Klasse abgeleitet werden, können die FindSiteMapNodeFromKey Methode außer Kraft setzen, um Nachschlagefunktionen basierend auf einem eindeutigen Schlüssel bereitzustellen (anstelle einer URL, die von der SiteMapProvider FindSiteMapNode Methode verwendet wird). Implementieren Sie die FindSiteMapNodeFromKey Methode, wenn ihre Websitezuordnungsanbieterimplementierung die SiteMapNode.Key Eigenschaft eines SiteMapNode Objekts als primärer Bezeichner in einer Websitezuordnungsstruktur verwendet.

Die StaticSiteMapProvider Klasse stellt eine Implementierung bereit, die die Suche nach Websitezuordnungsknoten behandelt, die keine URL definieren.

Die XmlSiteMapProvider Klasse, die der Standardwebsitezuordnungsanbieter für ASP.NET ist, verwendet die URL einer SiteMapNode als Schlüssel in den verschiedenen Sammlungen, die die Klassen verwalten. Wenn ein Knoten eine URL bereitstellt, muss es daher innerhalb des Bereichs des Websitezuordnungsanbieters eindeutig sein. Wenn keine URL bereitgestellt wird, wird ein eindeutiger Bezeichner generiert, um die SiteMapNode.

Gilt für

Siehe auch