StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

SiteMapNode Načte 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íč, se kterým se SiteMapNode vytvoří.

Návraty

SiteMapNode

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

Poznámky

Metoda FindSiteMapNodeFromKey načte uzel mapy webu z interního Hashtable objektu na keyzákladě .

ObjektXmlSiteMapProvider, který je odvozen z StaticSiteMapProvider třídy a je výchozím poskytovatelem mapy webu pro ASP.NET, ve výchozím nastavení používá Url vlastnost SiteMapNode objektu jako vyhledávací klíč ve svých interních kolekcích. Url Pokud je vlastnost nastavenaSiteMapNode, musí být jedinečná v rozsahu poskytovatele mapy webu. Metoda FindSiteMapNode se pokusí načíst uzly mapy webu na základě jejich Url. V opačném případě můžete použít Key vlastnost a odpovídající FindSiteMapNodeFromKey metodu k načtení uzlů mapy webu.

Má StaticSiteMapProvider výchozí implementaci, která vyhledá instance SiteMapNode třídy na základě parametru key . Pokud implementátor mapy webu použil metodu AddNode , StaticSiteMapProvider již bude mít uložen odkaz na každý SiteMapNode z nich na základě hodnoty SiteMapNode.Key vlastnosti. Ve výchozím nastavení generuje identifikátory GUID pro instance SiteMapNode třídy, XmlSiteMapProvider které nemají hodnotu pro SiteMapNode.Url vlastnost. Implementátoři vlastní mapy webu musí poskytnout vlastní mechanismus pro generování jedinečných SiteMapNode.Key hodnot vlastnosti v případě, že instance SiteMapNode třídy nemá hodnotu pro SiteMapNode.Url vlastnost.

Třídy SiteMapProvider a XmlSiteMapProvider třídy, které jsou výchozí implementací zprostředkovatele map webu pro ASP.NET, používají adresu URL SiteMapNode objektu jako klíč v různých kolekcích, které třídy udržují.

Viz také

• FindSiteMapNode