SiteMapProvider.FindSiteMapNodeFromKey(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte SiteMapNode objekt na základě zadaného klíče.
public:
virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNode
Parametry
- key
- String
Vyhledávací klíč, pomocí kterého SiteMapNode se vytvoří.
Návraty
A SiteMapNode , který představuje stránku označenou key
; jinak , null
pokud není nalezena žádná odpovídající SiteMapNode nebo pokud je povolené oříznutí zabezpečení a SiteMapNode nelze ho vrátit pro aktuálního uživatele. Výchozí formát je null
.
Poznámky
Implementace SiteMapProvider se vrátí null
ve všech případech. Třídy odvozené z SiteMapProvider třídy mohou přepsat metodu FindSiteMapNodeFromKey pro poskytování vyhledávacích funkcí na základě jedinečného klíče (místo adresy URL, která je používána metodou FindSiteMapNode ). Implementujte metodu FindSiteMapNodeFromKey , pokud implementace zprostředkovatele mapy webu používá SiteMapNode.Key vlastnost objektu SiteMapNode jako primární identifikátor ve struktuře mapy lokality.
Třída StaticSiteMapProvider poskytuje implementaci, která zpracovává vyhledávání uzlů mapy webu, které nedefinují adresu URL.
TřídaXmlSiteMapProvider, která je výchozím poskytovatelem map webů pro ASP.NET, používá adresu URL SiteMapNode jako klíč v různých kolekcích, které třídy udržují. Proto pokud uzel poskytuje adresu URL, musí být jedinečný v rozsahu poskytovatele mapy webu. Pokud není k dispozici žádná adresa URL, vygeneruje se jedinečný identifikátor pro identifikaci SiteMapNode.