XmlSiteMapProvider.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:
override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParameter
- key
- String
Ein Suchschlüssel, mit dem nach einem SiteMapNode gesucht werden kann.
Gibt zurück
Ein SiteMapNode, der die von key identifizierte Seite darstellt. Andernfalls null, wenn Einschränkungen aus Sicherheitsgründen aktiviert sind und der Knoten dem aktuellen Benutzer nicht angezeigt werden kann bzw. der Knoten von key in der Knotenauflistung nicht gefunden wird.
Ausnahmen
Ein untergeordneter, mit dem aktuellen Siteübersichtsanbieter verknüpfter Anbieter hat einen ungültigen Knoten zurückgegeben.
Hinweise
Die XmlSiteMapProvider -Klasse überschreibt die FindSiteMapNodeFromKey -Methode, um sicherzustellen, dass alle verknüpften untergeordneten Anbieter nach dem Knoten gesucht werden, wenn die Implementierung für die Basisklasse keinen Knoten für keyzurückgibt.
Das XmlSiteMapProvider -Objekt, das von der StaticSiteMapProvider -Klasse und dem standardmäßigen Siteübersichtsanbieter für ASP.NET abgeleitet 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 Anbieters eindeutig sein. Wenn kein Url angegeben ist, generiert automatisch XmlSiteMapProvider eine Key , um die Knoten nachzuverfolgen.
Die FindSiteMapNodeFromKey -Methode kann die BuildSiteMap -Methode für alle untergeordneten Anbieter aufrufen, die dem aktuellen Anbieter zugeordnet sind. Daher können die in der BuildSiteMap -Methode beschriebenen Ausnahmen ausgelöst werden.
