SiteMapProvider.FindSiteMapNodeFromKey(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 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.SiteMapNodePublic Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParameter
- key
- String
Ein Suchschlüssel, mit dem ein SiteMapNode erstellt wird.
Gibt zurück
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.