XmlSiteMapProvider.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 nach einem SiteMapNode gesucht werden kann.

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 Knoten dem aktuellen Benutzer nicht angezeigt werden kann bzw. der Knoten von key in der Knotenauflistung nicht gefunden wird.

Ausnahmen

ProviderException

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.

Weitere Informationen

• FindSiteMapNode