StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 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í.
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
node
je null
.
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.