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 basierend auf einem angegebenen Schlüssel 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 Nachschlageschlüssel, mit dem gesucht SiteMapNodewerden soll.
Gibt zurück
A SiteMapNode that represents the page identified by key; otherwise, if nullsecurity 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 Anbieter, der mit dem aktuellen Websitezuordnungsanbieter verknüpft ist, hat einen ungültigen Knoten zurückgegeben.
Hinweise
Die XmlSiteMapProvider Klasse setzt die FindSiteMapNodeFromKey Methode außer Kraft, um sicherzustellen, dass alle verknüpften untergeordneten Anbieter nach dem Knoten gesucht werden, wenn die Implementierung für die Basisklasse keinen Knoten keyzurückgibt.
Das XmlSiteMapProvider Objekt, das von der StaticSiteMapProvider Klasse und dem Standardwebsitezuordnungsanbieter für ASP.NET abgeleitet wird, verwendet standardmäßig die Url Eigenschaft eines SiteMapNode Objekts als Nachschlageschlüssel in seinen internen Auflistungen. Wenn die Url Eigenschaft des SiteMapNode Satzes festgelegt ist, muss sie innerhalb des Bereichs des Anbieters eindeutig sein. Wenn kein Url Wert angegeben ist, wird automatisch XmlSiteMapProvider ein Key Knoten generiert, 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.
