StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een SiteMapNode object opgehaald op basis van een opgegeven sleutel.
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 SiteMapNodeParameters
- key
- String
Een opzoeksleutel waarmee een SiteMapNode wordt gemaakt.
Retouren
Een SiteMapNode die de pagina vertegenwoordigt die wordt geïdentificeerd door key; anders, nullals beveiligingsbeperkingen zijn ingeschakeld en het siteoverzichtknooppunt niet kan worden weergegeven aan de huidige gebruiker of het siteoverzichtknooppunt niet wordt gevonden in de siteoverzichtknooppuntverzameling door key.
Opmerkingen
De FindSiteMapNodeFromKey methode haalt een siteoverzichtknooppunt op van een intern Hashtable object op keybasis van .
Het XmlSiteMapProvider-object, dat is afgeleid van de klasse StaticSiteMapProvider en de standaardsiteoverzichtprovider voor ASP.NET is, gebruikt standaard de eigenschap Url van een SiteMapNode-object als zoeksleutel in de interne verzamelingen. Als de eigenschap van de UrlSiteMapNode set is ingesteld, moet deze uniek zijn binnen het bereik van de siteoverzichtprovider. De FindSiteMapNode methode probeert siteoverzichtknooppunten op te halen op basis van hun Url. Anders kunt u de Key eigenschap en de bijbehorende FindSiteMapNodeFromKey methode gebruiken om siteoverzichtknooppunten op te halen.
De StaticSiteMapProvider heeft een standaard implementatie waarmee exemplaren van de SiteMapNode klasse worden opgezoekd op basis van de key parameter. Als een implementeerfunctie van een siteoverzichtprovider de AddNode methode heeft gebruikt, heeft de StaticSiteMapProvider provider al een verwijzing naar elk SiteMapNode bestand opgeslagen op basis van de waarde van de SiteMapNode.Key eigenschap. Standaard genereert de XmlSiteMapProvider GUID's voor exemplaren van de SiteMapNode klasse die geen waarde voor de SiteMapNode.Url eigenschap hebben. Implementeerfuncties van aangepaste siteoverzichtproviders moeten hun eigen mechanisme opgeven voor het genereren van unieke waarden van de SiteMapNode.Key eigenschap in het geval dat een exemplaar van de SiteMapNode klasse geen waarde voor de SiteMapNode.Url eigenschap heeft.
De klassen SiteMapProvider en XmlSiteMapProvider, die de standaard implementatie van de siteoverzichtprovider voor ASP.NET zijn, gebruiken de URL van een SiteMapNode-object als sleutel in de verschillende verzamelingen die de klassen onderhouden.
