StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

SiteMapNode Přidá do kolekcí, které spravuje zprostředkovatel mapy webu, a vytvoří vztah nadřazenosti/podřízenosti mezi SiteMapNode 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

Přidání SiteMapNode do zprostředkovatele mapy webu

parentNode

SiteMapNode

Pod SiteMapNode kterou chcete přidat node.

Výjimky

ArgumentNullException

node je null.

InvalidOperationException

Key Nebo Url je již registrován v sadě 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 identifikovaný parametrem node se přidá do interní kolekce a vytvoří se mezi ním vztah nadřazený-podřízený a uzel mapy webu identifikovaný parametrem parentNode .

Při přidání do interních kolekcí může být adresa URL uzlu mapy webu interpretována. Relativní a relativní adresy URL aplikace jsou rozšířeny na absolutní virtuální cesty aplikace, které se pak používají interně 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 v nich a cesty UNC, nejsou interpretovány.

Třída XmlSiteMapProvider , která je odvozena z StaticSiteMapProvider třídy 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 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 vlastnosti. 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í zadáno Url nebo Key není zadáno, zprostředkovatel mapy webu automaticky vygeneruje trasu Key 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 je vlastnost nastavena na jedinečnou hodnotu při přidání uzlu mapy webu pomocí AddNode metody.

Viz také

• RemoveNode(SiteMapNode)