StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Dodaje obiekt SiteMapNode do kolekcji, które są obsługiwane przez dostawcę mapy witryny i ustanawia relację elementu nadrzędnego/podrzędnego między SiteMapNode obiektami.

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

Element SiteMapNode do dodania do dostawcy mapy lokacji.

parentNode

SiteMapNode

Element SiteMapNode , pod którym ma zostać dodany nodeelement .

Wyjątki

ArgumentNullException

node to null.

InvalidOperationException

Element Url lub Key jest już zarejestrowany w obiekcie StaticSiteMapProvider. Węzeł mapy witryny musi składać się z stron z unikatowymi adresami URL lub kluczami.

Uwagi

Węzeł mapy witryny, który jest identyfikowany przez node parametr, jest dodawany do kolekcji wewnętrznej, a relacja nadrzędny-podrzędna jest tworzona między nim a węzłem mapy witryny, który jest identyfikowany przez parentNode parametr .

Adres URL węzła mapy witryny może być interpretowany po dodaniu go do kolekcji wewnętrznych. Adresy URL względne i względne aplikacji są rozszerzane na ścieżki wirtualne bezwzględne aplikacji, które są następnie używane wewnętrznie do przechowywania i uzyskiwania dostępu do poszczególnych wystąpień SiteMapNode klasy. Inne adresy URL, takie jak ścieżki fizyczne, ścieżki z protokołami w nich i ścieżki UNC, nie są interpretowane.

XmlSiteMapProvider Klasa, która pochodzi z StaticSiteMapProvider klasy i jest domyślnym dostawcą mapy lokacji dla ASP.NET, domyślnie używa Url właściwości SiteMapNode obiektu jako klucza odnośnika w swoich kolekcjach wewnętrznych. Url Jeśli właściwość SiteMapNode jest ustawiona, musi być unikatowa w zakresie dostawcy mapy lokacji. Metoda FindSiteMapNode próbuje pobrać węzły mapy lokacji na podstawie ich Url właściwości. W przeciwnym razie można użyć Key właściwości i odpowiedniej FindSiteMapNodeFromKey metody w celu pobrania węzłów mapy witryny. Jeśli nie Url określono elementu lub Key nie zostanie określony, dostawca mapy lokacji automatycznie wygeneruje obiekt Key w celu śledzenia węzłów mapy lokacji.

Uwagi dotyczące dziedziczenia

Podczas zastępowania AddNode(SiteMapNode, SiteMapNode) metody upewnij się, że Key właściwość jest ustawiona na unikatową wartość podczas dodawania węzła mapy witryny przy użyciu AddNode metody .

Zobacz też

• RemoveNode(SiteMapNode)