XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Methode

Definition

Ruft ein SiteMapNode-Objekt auf Grundlage eines angegebenen Schlüssels ab.Retrieves a SiteMapNode object based on a specified key.

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.A lookup key with which to search for a SiteMapNode.

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.A SiteMapNode that represents the page identified by key; otherwise, null, if security trimming is enabled and the node cannot be shown to the current user or the node is not found by key in the node collection.

Ausnahmen

Ein untergeordneter, mit dem aktuellen Siteübersichtsanbieter verknüpfter Anbieter hat einen ungültigen Knoten zurückgegeben.A child provider linked to the current site map provider returned a node that is not valid.

Hinweise

Die XmlSiteMapProvider -Klasse überschreibt FindSiteMapNodeFromKey die-Methode, um sicherzustellen, dass alle verknüpften untergeordneten Anbieter nach dem Knoten durchsucht werden, wenn die Implementierung für die keyBasisklasse keinen Knoten für zurückgibt.The XmlSiteMapProvider class overrides the FindSiteMapNodeFromKey method to ensure that any linked child providers are searched for the node, if the implementation for the base class does not return a node for key.

Das XmlSiteMapProvider -Objekt, das von StaticSiteMapProvider der-Klasse und dem standardmäßigen Site Übersichts Anbieter für ASP.net Url abgeleitet ist, SiteMapNode verwendet standardmäßig die-Eigenschaft eines-Objekts als Suchschlüssel in seinen internen Auflistungen.The XmlSiteMapProvider object, derived from the StaticSiteMapProvider class and the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. Wenn die Url -Eigenschaft SiteMapNode von festgelegt ist, muss Sie innerhalb des Bereichs des Anbieters eindeutig sein.If the Url property of the SiteMapNode is set, it must be unique within the scope of the provider. Wenn kein Url angegeben ist XmlSiteMapProvider , generiert automatisch eine Key zum Nachverfolgen der Knoten.If no Url is specified, the XmlSiteMapProvider automatically generates a Key to track the nodes.

Die FindSiteMapNodeFromKey -Methode kann die BuildSiteMap -Methode für alle untergeordneten Anbieter aufzurufen, die dem aktuellen Anbieter zugeordnet sind.The FindSiteMapNodeFromKey method might call the BuildSiteMap method on any child providers that are associated with the current provider. Daher können die Ausnahmen, die in der BuildSiteMap -Methode beschrieben werden, ausgelöst werden.Therefore, the exceptions that are described in the BuildSiteMap method might be thrown.

Gilt für:

Siehe auch