StaticSiteMapProvider.FindSiteMapNode(String) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Načte SiteMapNode objekt, který představuje stránku na zadané adrese URL.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);

public override System.Web.SiteMapNode FindSiteMapNode (string rawUrl);

override this.FindSiteMapNode : string -> System.Web.SiteMapNode

Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Parametry

rawUrl

String

Adresa URL, která identifikuje stránku, pro kterou se má načíst SiteMapNode.

Návraty

SiteMapNode

A SiteMapNode , který představuje stránku identifikovanou rawURL; v opačném případě , nullpokud nebyl nalezen žádný odpovídající uzel mapy webu.

Výjimky

ArgumentNullException

rawURL je null.

Poznámky

Zadaná adresa URL je obvykle virtuální nebo absolutní adresa URL. Může to být také adresa URL, která používá ASP.NET syntaxi relativní vzhledem k aplikaci, například "~/apprelativedirectory". Třída StaticSiteMapProvider automaticky normalizuje nezpracované adresy URL relativní vzhledem k aplikaci na absolutní virtuální cestu.

ObjektXmlSiteMapProvider, který je odvozen z StaticSiteMapProvider 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. Pokud není Url zadána nebo Key není zadána, poskytovatel mapy webu automaticky vygeneruje Key vlastnost pro sledování uzlů mapy webu.

Poznámky pro dědice

Při přepsání FindSiteMapNode(String) metody v odvozené třídě nezapomeňte normalizovat adresy URL SiteMapNode objektů, které přidáte do poskytovatele mapy webu, aby FindSiteMapNode(String) metoda mohl načíst uzel mapy webu bez ohledu na to, zda je adresa URL pro uzel mapy webu zadána jako absolutní virtuální cesta nebo relativní cesta aplikace.

Chování oříznutí zabezpečení je součástí SiteMapProvider implementací tříd StaticSiteMapProvider . Aby však oříznutí zabezpečení fungovalo v odvozených třídách, je nutné nastavit Roles vlastnost všech SiteMapNode objektů, které vytvoříte při vytváření zprostředkovatele mapy webu při přepsání BuildSiteMap() metody.

Viz také

• BuildSiteMap()
• FindSiteMapNodeFromKey(String)