StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Fügt den vom Siteübersichtsanbieter verwalteten Auflistungen einen SiteMapNode hinzu und richtet eine Über- bzw. Unterordnungsbeziehung zwischen den SiteMapNode-Objekten ein.

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)

Parameter

node

SiteMapNode

Der dem Siteübersichtsanbieter hinzuzufügende SiteMapNode.

parentNode

SiteMapNode

Der SiteMapNode, unter dem node hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

node ist null.

InvalidOperationException

Der Url oder der Key ist bereits beim StaticSiteMapProvider registriert. Ein Siteübersichtsknoten muss aus Seiten mit eindeutigen URLs oder Schlüsseln bestehen.

Hinweise

Der durch den node Parameter identifizierte Siteübersichtsknoten wird einer internen Auflistung hinzugefügt, und zwischen ihr und dem Durch den parentNode Parameter identifizierten Siteübersichtsknoten wird eine Beziehung zwischen übergeordnetem und untergeordnetem Element erstellt.

Die URL für einen Siteübersichtsknoten kann interpretiert werden, wenn er den internen Sammlungen hinzugefügt wird. Anwendungs relative und relative URLs werden auf anwendungsunabhängige virtuelle Pfade erweitert, die dann intern zum Speichern und Zugreifen auf die einzelnen Instanzen der SiteMapNode -Klasse verwendet werden. Andere URLs, z. B. physische Pfade, Pfade mit Protokollen und UNC-Pfade, werden nicht interpretiert.

Die XmlSiteMapProvider Klasse, die von der StaticSiteMapProvider -Klasse abgeleitet ist und der Standardanbieter für die Siteübersicht für ASP.NET ist, verwendet standardmäßig die Url Eigenschaft eines SiteMapNode Objekts als Nachschlageschlüssel in seinen internen Auflistungen. Wenn die Url -Eigenschaft von SiteMapNode festgelegt ist, muss sie innerhalb des Bereichs des Siteübersichtsanbieters eindeutig sein. Die FindSiteMapNode -Methode versucht, Siteübersichtsknoten basierend auf ihrer Url Eigenschaft abzurufen. Andernfalls können Sie die Key -Eigenschaft und die entsprechende FindSiteMapNodeFromKey Methode verwenden, um Siteübersichtsknoten abzurufen. Wenn nicht Url oder Key angegeben ist, generiert der Siteübersichtsanbieter automatisch eine Key , um die Siteübersichtsknoten nachzuverfolgen.

Hinweise für Vererber

Stellen Sie beim Überschreiben der AddNode(SiteMapNode, SiteMapNode) -Methode sicher, dass die Key Eigenschaft auf einen eindeutigen Wert festgelegt ist, wenn Sie den Siteübersichtsknoten mithilfe der AddNode -Methode hinzufügen.

Weitere Informationen

• RemoveNode(SiteMapNode)