StaticSiteMapProvider.FindSiteMapNode(String) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

SiteMapNode Načte 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 identifikující stránku, pro kterou se má načíst SiteMapNode.

Návraty

SiteMapNode

A SiteMapNode , který představuje stránku určenou rawURL; jinak , nullpokud se nenajde žá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 adresy URL relativní vzhledem k aplikaci na absolutní virtuální cestu.

Objekt XmlSiteMapProvider , který je odvozen od 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íč v jeho interních kolekcích. Url Pokud je vlastnost SiteMapNode nastavena, musí být jedinečná v rámci 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áno nebo Key není zadáno, zprostředkovatel 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 zprostředkovatele 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 implementace třídy 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)