StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar ett SiteMapNode objekt baserat på en angiven nyckel.
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 SiteMapNodeParametrar
- key
- String
En uppslagsnyckel som en SiteMapNode skapas med.
Returer
En SiteMapNode som representerar sidan som identifieras av key, annars , nullom säkerhetstrimning är aktiverad och platsmappningsnoden inte kan visas för den aktuella användaren eller om platskartenoden inte hittas i nodsamlingen för webbplatskartan av key.
Kommentarer
Metoden FindSiteMapNodeFromKey hämtar en platsmappningsnod från ett internt Hashtable objekt baserat på key.
Objektet XmlSiteMapProvider, som härleds från klassen StaticSiteMapProvider och är standardplatsmappningsprovidern för ASP.NET, använder egenskapen Url för ett SiteMapNode-objekt som en uppslagsnyckel i sina interna samlingar som standard. Om egenskapen Url för SiteMapNode har angetts måste den vara unik inom webbplatsöversiktsproviderns omfång. Metoden FindSiteMapNode försöker hämta platsmappningsnoder baserat på deras Url. Annars kan du använda Key egenskapen och motsvarande FindSiteMapNodeFromKey metod för att hämta platsmappningsnoder.
StaticSiteMapProvider Har en standardimplementering som söker upp instanser av SiteMapNode klassen baserat på parameternkey. Om en webbplatsöversiktsprovider implementerare använde AddNode metoden, StaticSiteMapProvider har redan lagrat en referens till var och SiteMapNode en baserat på värdet för SiteMapNode.Key egenskapen. Som standard XmlSiteMapProvider genererar GUID:erna för instanser av SiteMapNode klassen som inte har något värde för SiteMapNode.Url egenskapen. Implementerare för anpassad webbplatsöversiktsprovider måste tillhandahålla en egen mekanism för att generera unika värden SiteMapNode.Key för egenskapen i händelse av att en instans av SiteMapNode klassen inte har något värde för SiteMapNode.Url egenskapen.
Klasserna SiteMapProvider och XmlSiteMapProvider, som är standardimplementeringen för webbplatsöversiktsprovidern för ASP.NET, använder URL:en för ett SiteMapNode-objekt som en nyckel i de olika samlingar som klasserna underhåller.
