XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Načte SiteMapNode objekt na základě zadaného klíče.

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

Parametry

key

String

Vyhledávací klíč, pomocí kterého chcete vyhledat SiteMapNode.

Návraty

SiteMapNode

A SiteMapNode , která představuje stránku identifikovanou pomocí key; v opačném případě , nullpokud je povolené oříznutí zabezpečení a uzel nelze zobrazit aktuálnímu uživateli nebo uzel není nalezen v kolekci key uzlů.

Výjimky

ProviderException

Podřízený zprostředkovatel propojený s aktuálním poskytovatelem mapy webu vrátil uzel, který není platný.

Poznámky

Třída XmlSiteMapProvider přepíše metodu FindSiteMapNodeFromKey , aby se zajistilo, že se pro uzel vyhledávají podřízení zprostředkovatelé propojení, pokud implementace základní třídy nevrací uzel pro key.

Objekt XmlSiteMapProvider odvozený z StaticSiteMapProvider třídy a výchozího zprostředkovatele mapy webu pro ASP.NET používá Url vlastnost objektu SiteMapNode jako vyhledávací klíč ve svých interních kolekcích, ve výchozím nastavení. Url Pokud je vlastnost nastavenáSiteMapNode, musí být jedinečná v rámci rozsahu zprostředkovatele. Pokud je zadáno ne Url , XmlSiteMapProvider nástroj automaticky vygeneruje Key pro sledování uzlů.

Metoda FindSiteMapNodeFromKey může volat metodu BuildSiteMap u všech podřízených zprostředkovatelů, kteří jsou přidruženi k aktuálnímu poskytovateli. Proto mohou být vyvolány výjimky, které jsou popsány BuildSiteMap v metodě.

Viz také

• FindSiteMapNode