StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Metoda

  • Reference

Definice

Obor názvů:
System.Web
Sestavení:
System.Web.dll

Přidá objekt SiteMapNode do kolekcí, které jsou spravovány zprostředkovatelem mapy webu, a vytvoří vztah nadřazenosti a podřízenosti SiteMapNode mezi objekty.

protected public:
 override void AddNode(System::Web::SiteMapNode ^ node, System::Web::SiteMapNode ^ parentNode);
protected internal override void AddNode (System.Web.SiteMapNode node, System.Web.SiteMapNode parentNode);
override this.AddNode : System.Web.SiteMapNode * System.Web.SiteMapNode -> unit
Protected Friend Overrides Sub AddNode (node As SiteMapNode, parentNode As SiteMapNode)

Parametry

node
SiteMapNode

Chcete-li SiteMapNode přidat do poskytovatele mapy webu.

parentNode
SiteMapNode

Pod SiteMapNode kterou se má přidat node.

Výjimky

ArgumentNullException

node je null.

InvalidOperationException

Hodnota Url nebo Key je již zaregistrovaná u .StaticSiteMapProvider Uzel mapy webu musí být tvořen stránkami s jedinečnými adresami URL nebo klíči.

Poznámky

Uzel mapy webu, který je identifikován parametrem node , se přidá do interní kolekce a vytvoří se vztah nadřazenosti a podřízenosti mezi ním a uzlem mapy webu, který je identifikován parametrem parentNode .

Při přidání do interních kolekcí může být interpretována adresa URL uzlu mapy webu. Adresy URL relativní a relativní k aplikaci jsou rozšířeny na absolutní virtuální cesty aplikace, které se pak interně používají k ukládání a přístupu k jednotlivým instancím SiteMapNode třídy. Jiné adresy URL, jako jsou fyzické cesty, cesty s protokoly a cesty UNC, se interpretují.

Třída XmlSiteMapProvider , která je odvozena od StaticSiteMapProvider třídy a je výchozím zprostředkovatelem mapy webu pro ASP.NET, ve výchozím nastavení používá Url vlastnost objektu SiteMapNode jako vyhledávací klíč ve svých interních kolekcích. Url Pokud je vlastnost nastavenaSiteMapNode, 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 vlastnosti. V opačném případě můžete k načtení uzlů mapy webu použít Key vlastnost a odpovídající FindSiteMapNodeFromKey metodu. Pokud není zadáno Url žádné nebo Key je zadáno, poskytovatel mapy webu automaticky vygeneruje Key uzel pro sledování uzlů mapy webu.

Poznámky pro dědice

Při přepsání AddNode(SiteMapNode, SiteMapNode) metody se ujistěte, že Key vlastnost je nastavena na jedinečnou hodnotu při přidávání uzlu mapy webu pomocí AddNode metody.

Platí pro

Viz také